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Chapter 1 


Introduction 


A few years ago, my computer was a small home computer. When I became 
interested in the IBM PC, I had to learn a lot of new things. I learned about MS- 
DOS and became familiar with 8088 assembly language. I soon reached a point 
where I started developing commercial PC programs in partnership with my friend 
Axel Sellemerten. All of this happened some time ago, but I still clearly 
remember sitting at my desk, looking through dozens of PC books and technical 
manuals, trying to find a critical piece of information. 


These books and manuals were expensive and hard to find. Besides, none of them 
covered all aspects of the PC. Some books tell you about PC hardware or the 
BIOS or DOS. I could never find a book that dealt with the PC as a total system. 
No single book was able to provide me with a complete system overview. 


This book is the result of my experience with all of these references. The three 
main areas of the PC (hardware, the BIOS and DOS) are combined in this book 
from a software developer’s point of view. This book was written to serve as an 
instruction book as well as a reference manual. It is not, and was never intended to 
be, a book for the beginner. The book assumes that you’re familiar with MS-DOS 
and are able to program in one of the four most popular PC programming 
languages (machine language, BASIC, Pascal or C). 


Organization 


The book is divided into five parts. Part 1 (Chapters 1-5) gives an introduction to 
the PC’s internal components. Part 2 (Chapter 6) describes the Disk Operating 
System (DOS) and Part 3 (Chapter 7) describes the Basic Input Output System 
(BIOS). PC hardware that is not part of the central processor is discussed in Part 4 
(Chapters 8-18). Part 5 (Chapter 19) describes the interaction between these 
components and the keyboard. The book concludes with a large reference section 
(Appendices) containing all functions of DOS and the BIOS, among other things. 


To understand the content of this book, you must first know something about the 
different number systems used in computers. Readers unfamiliar with the binary 
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and hexadecimal number systems should read Appendix G (Introduction to Number 
Systems) before continuing. 


Chapters 2 through 5 contain descriptions of PC microprocessors and interrupts. If 
you’re an experienced assembly language programmer you can skip these chapters, 
but you may learn something new by reading them anyway. 


BASIC, Pascal and C programmers should read Chapters 2 and 3 and should work 
through the subsections in Chapter 4 devoted to your preferred language. Chapter 5 
is devoted exclusively to assembly language programming and may be skipped. 


Chapter 2 


The PC's Brain 


While working with the PC, many users have wondered about its ability to solve 
complex problems. Users often attribute these abilities to the software or operating 
system. The fact is, hardware is as important as the software. 


Microprocessor 


Intel’s 


The microprocessor is the brain of the PC. It understands a limited number of 
machine language instructions and processes or executes programs in this machine 
language. These instructions are very simple and can’t be compared to commands 
in high level languages such as BASIC, Pascal or C. Commands in these 
languages must be translated into a large number of machine language instructions 
that the PC’s microprocessor can then execute. For example, displaying text with 
the BASIC PRINT statement requires the equivalent of several hundred machine 
language instructions. 


Machine language instructions differ for each microprocessor used in different 
computers. When you hear someone talk about Z-80, 6502 or 8088 machine 
language, these terms refer to the microprocessor being programmed. 


80xx series 


The PC has its own family of microprocessor chips, all designed by the Intel 
Corporation. The figure on the next page describes the Intel 80xx family tree. 
Your PC may contain an 8086, an 8088 (used in the PC/XT), an 80186, an 80286 
(used in the AT) or even an 80386 microprocessor. The first generation of this 
group (the 8086) was developed in 1978. The successors of the 8086 were different 
from the original chip. The 8088 is actually a step backward since it has the same 
internal structure and instructions of the 8086, but is slower than the 8086. The 
reason is that the 8086 transfers 16 bits (2 bytes) between memory and the 
microprocessor at one time. The 8088 is slower since it transfers only 8 bits (1 
byte) at one time. 
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Multiprocessing 


The three other microprocessors of this family are improved versions of the 8086. 
The 80186 offers auxiliary functions. The 80286 has additional registers and 
extended addressing capabilities. The 80286’s biggest advantages over its 

predecessors are its multiprocessing and virtual memory capabilities. 
Multiprocessing allows several programs to execute at the same time, such as 
compiling a program while using a word processor. This capability, which is 
based on the fast switching between the individual programs, can also be 
implemented through software (e.g., Microsoft Windows®), but working directly 
through the processor is more efficient. 


Virtual memory 


Virtual memory means that a program appears to use much more memory than is 
available in the computer’s RAM. Portions of the programs or data which don’t fit 
into memory are temporarily stored on the mass storage device (floppy or hard 
disk). The computer loads these sections into RAM as needed. The CPU and the 
operating system share the task of virtual memory management. Earlier versions 
of MS-DOS don’t support the multiprocessing or virtual memory capabilities of 
the 80286, so most AT computers aren’t working to their full potential. 


74 75 76 7778 79 80 81 8283 84 85 86 8788 89 90 
Year 


The Intel 80xx processor family 
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The 80386 represents current state of the art technology. It has a more extensive 
instruction set than the 80286, and offers additional memory protection features. 


These processors are all upwardly compatible with software. This means that 
machine language programs developed for the 8086 can be executed on the other 
processors of this series. On the other hand, a program written for the 80386 may 
not run correctly on the 80286 or the 8088, because instructions available on the 
80386 may not be available in the earlier processors. 


Throughout this book the PC processor is designated as the 8088, even though 
your PC may use a different processor. 
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2.1 8088 Registers 


Registers are memory locations within the processor itself, instead of in RAM. 
These registers can be accessed much faster than RAM. In addition, registers are 
specialized memory locations. The CPU performs arithmetic and logical operations 
using its registers. 


Common Registers Segment Registers 


DATA SEGMENT 


EXTRA SEGMENT 
CODE SEGMENT 


STACK SEGMENT 


| SOURCE INDEX 
| STACK POINTER 
| BASER POINTER 
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8088 registers 


All registers are 16 bits (2 bytes) in size. If all 16 bits of a register contain a 1, 
this is the largest number that can be represented within 16 bits. This number is 
the decimal number 65535. Therefore, a register can contain any value from 0 to 
65535. 


Register groupings 


As shown in the above figure, registers are divided into four groups: common 
registers, segment registers, the program counter and the flag register. The different 
register assignments are designed to duplicate the way in which a program 
processes data—which is the basic task of a microprocessor. 


The disk operating system and the routines stored in ROM use the common 
registers a great deal, especially the AX, BX, CX and DX registers. The contents 
of these registers tell DOS what tasks it should perform and which data to use for 
execution. 
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These registers are affected mainly by mathematical (addition, subtraction, etc.) and 
input/output instructions. They are assigned a special position within the registers 
of the 8088 because they can be separated into two 8-bit (1-byte) registers. Each 
common register may be thought to consist of three registers: a single 16-bit 
register, or two smaller 8-bit registers. 


bit 15 bit8 bit 7 bit 0 
AH AL 
bit 15 bit 0 
AX register 


The registers have designators of H (high) and L (low). Thus the 16-bit AX 
register may be divided into an 8-bit AH and an 8-bit AL register. The H and the L 
register designators occur in such a way that the L register contains the lower 8 
bits (bit O through 7) of the X register, and the H register the higher 8 bits (bits 8 
through 15) of the X register. The AH register consists of bits 8-15 and the AL 
register of bits 0-7 of the AX register. However, the three registers cannot be 
considered independent of each other. For example, if bit 3 of the AH register is 
changed, then the value of bit 11 of the AX register also changes automatically. 
The values change in both the AH and the AX registers. The value of the AL 
register remains constant since it is made of bits 0-7 of the AX register (bit 11 of 
the AX register does not belong to it). This connection between the AX, the AH 
and the AL register is also valid for all other common registers and can be 
expressed mathematically. 


You can determine the value of the X register from the values of the H and the L 
registers, and vice versa. To calculate the value of the X register, multiply the 
value of the H register by 256 and add the value of the L register. 


Example: The value of the CH register is 10, the value of the CL register is 
118. The value of the CX register results from CH*256+CL, which 
is 10*256+118 = 2678. 


Specifying register CH or CL, you can read or write an 8-bit data item from or to 
any memory location. Specifying register CX, you can read or write a 16-bit data 
item from or to a memory location. 
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2.2 


Segment and Offset Addressing 


One of the design goals of the 8088 was to provide an instruction set that was 
superior to the earlier 8-bit microprocessors (6502, Z80, etc.). A second goal was 
to provide easy access to more than 64 kilobytes of memory. This goal was of 
special importance since increasing processor capabilities allow programmers to 
write more complex applications, which in turn require more memory. The 
designers of the 8088 increased the memory capacity or address space of the 
microprocessor by more than 16 times to one megabyte. 


Address register 


The number of memory locations which a processor can access depends on the 
width of the address register. Since every memory location is accessed by 
specifying a unique number or address, the maximum value contained in the 
address register determines the address space. Earlier microprocessors used a 16-bit 
address register enabling access to addresses from 0 to 65535. This corresponds to 
the 64K memory capacity of these processors. 


To address one megabyte of memory the address register must be at least 20 bits 
wide. At the time the 8088 was developed, it was impossible to use a 20-bit 
address register, so the designers used an alternate way to achieve the 20-bit width: 
the contents of two different 16-bit numbers are used to form the 20-bit address. 


Segment register 


One of the numbers is contained in a segment register. The 8088 has four segment 
registers. The second number is contained in another register or in a memory 
location. To form a 20-bit number, the contents of the segment register are shifted 
left by 4 bits (thereby multiplying the value by 16) and the second number is added 
to the first. 


Segment and offset addresses 


These addresses are the segment address and the offset address. The segment address 
is formed by a segment register and indicates the start of a segment of memory. 
During the address formulation, the offset address is added to the segment address. 
The offset address indicates the number of the memory location within the segment 
whose beginning was defined by the segment register. Since the offset address can 
never be larger than 16 bits, a segment can be no larger than 65,535 bytes (64K). 


Segmented address 


The segmented address results from the combined segment and offset addresses. 
This segmented address specifies the exact number of the memory location which 
should be accessed. Unlike the segmented address, the segment and the offset 
addresses are relative addresses or relative offsets. 
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Memory structure using segment and offset addresses 


A segment cannot start at every one of the million or so memory locations. 
Multiplying the segment register by 16 always produces a segment address that is 
divisible by 16. For example, it’s not possible for a segment to begin at memory 
location 22. 


Combining the segment and offset addresses requires special notation to indicate a 
memory location’s address. This notation consists of the segment address in four- 
digit hexadecimal format, followed by a colon, and the offset address in four-digit 
hexadecimal format. For example, a memory location with a segment address of 
2000H and an offset address of AF3H would appear in this notation as 2000:0AF3. 
Because of this notation, you can omit the H suffix from hexadecimal numbers. 
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25FFFH = 

25FFEH Qe 

© 

3 

NST = 

3 

Offset D 

171 05H address = 1104H 2. 

Segment 17104H ——_______—.__—— a 

3 

Offset = 

“< 

o 

2. 

2. 

— 

a D 

Segment ~ 

address = 1600H . 
Segment and offset address 


The 8088 has four segment registers, which have special roles in the execution of 
an assembly language program. There are four registers to accommodate the basic 
structure of any program. A program consists of a set of instructions (code). There 
are also variables and data items that are processed by the program. A structured 
program keeps the code and data separate from each other while they reside in 
memory. Assigning code and data their own segments conveniently separates 
them. 


Each needs a segment address and a segment register. The CS (Code Segment) 
register uses the IP (Instruction Pointer) register as the offset address. The CS then 
determines the address at which the next assembly language instruction is located. 
The IP is also called the Program Counter. When the processor executes the 
current instruction, the IP register is automatically incremented to point to the 
next assembly language instruction. This ensures the execution of instructions in 
the correct order. 


Like the CS register, the DS (Data Segment) register contains the segment address 
of the data which the program accesses (writing or reading data to or from 
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memory). The offset address is added to the content of the DS register and may be 
contained in another register or may be contained as part of the current instruction. 


The SS (Stack Segment) register specifies the starting address of the stack. The 
stack acts as temporary storage space by some assembly language programs. It 
allows fast storage and retrieval of data for various instructions. For example, 
when the CALL instruction is executed, the processor places the return address on 
the stack. The SS register and either the SP or BP registers form the address that is 
pushed onto the stack. 


The last segment register is the ES (Extra Segment) register. It is used by some 
assembly language instructions to address more than 64K of data or to transfer data 
between two different segments of memory. 


ES: FETE ai 7 

Uy PRL ASESLLLL 
ES: 0000 i | eameenrerare 
COeFRER: [aca 2 ea 


CS: 0000 


SS:FFFF 
SS: FFFF 
S$: 0000 DS: FFFF 
DS:FFFF 55: 0000 
DS: 0000 F 
DS: 0000 
Non-overlapping Overlapping 
segments segments 


Overlapping and non-overlapping segments 


As the figure above shows, two segment registers can specify areas of memory 
which overlap, or are completely different from one another. In many cases, a 
program doesn’t require a full 64K segment for storing code or data. You can 
conserve memory by overlapping the segments. For example, you can store data 
immediately following the program code by setting the DS and CS registers 
accordingly. 
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The flag register is of special importance. Various bits in this register indicate or 
signal the special conditions which may occur during execution of an assembly 
language instruction. For example, if an arithmetic operation results in a negative 
number, the processor sets the S (sign) flag to 1 to indicate this change. 


The C (carry) flag is set to 1 if the sum of two 8-bit numbers cannot be 
represented as an 8-bit number. 


As the figure above shows, the processor doesn’t use all 16 bits of this register. 
The unused bits normally contain the value 0. 


This ends our short trip into the PC’s brain. If you didn’t quite follow some of 
these concepts, the sample application programs in the sections on the BIOS and 
DOS functions should help you understand. 
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The CPU Support Chips 


The microprocessor is the computer’s brain, and is probably the most intelligent 
component in a computer system. However, it cannot supervise all the computer’s 
functions on its own. For this reason, other components called support chips 
perform many other tasks, leaving the processor to concentrate on its primary task 
of executing assembly language programs. 


These support chips communicate with and control external peripherals such as a 
disk drive or the screen display. 


Some of these support chips can be programmed using the assembly language 
instructions IN and OUT. Since the programming of most support chips is very 
complex, we recommend that you leave this up to DOS, unless you have a 
complete understanding of the structure and operation of these chips. 


The following sections define the most important support chips in the PC. 


The DMA Controller 


This chip gets its name from the acronym DMA which stands for Direct Memory 
Access. This chip can directly write data to or read data from RAM. The DMA 
controller performs disk input/output operations, moving data from RAM to disk 
or from disk to RAM. This relieves the processor of this task and accelerates 
program execution. 


The Interrupt Controller 


Interrupts are signals from individual components of the system to get the CPU’s 
attention and to initiate certain tasks. Several interrupts or requests for services 
from different system components can be outstanding at one time. These requests 
are initially handled by the interrupt controller, which passes them on to the CPU. 
It assigns priority to every interrupt request according to its source and passes the 
request with the highest priority to the CPU. The interrupt controller in the 
PC/XT can process up to 8 interrupt requests at the same time. ATs require more 
power, so they use two interconnected interrupt controllers which can process up 
to 15 interrupt requests simultaneously. 


The Programmable Peripheral Interface 


This chip provides a link between the CPU and the peripherals such as the 
keyboard or an audio speaker. However, it only operates as a mediator, addressed by 
the CPU for unit access and transmission of certain signals. You cannot bypass 
the PPI for direct communication between the CPU and peripherals. 
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If the microprocessor is the brain of the computer, then the clock could be 
considered the heart of the computer. This heart beats several million times a 
second (about 14.3 megaHertz) and paces the microprocessor and the other chips in 
the system. Since almost none of the chips operate at such high frequencies, each 
support chip modifies the clock frequency to its own requirements. 


The Timer 


The timer chip can be used as a counter and timekeeper. This chip transmits 
constant electrical pulses from one of its output pins. The frequency of these 
pulses can be programmed as needed, and each output pin can have its own 
frequency. Each output pin leads to another component. One line goes to the audio 
speaker and another to the interrupt controller. The line to the interrupt controller 
triggers interrupt 8 at every pulse, which advances the timer count. 


The Screen Controller 


Unlike the chips discussed up until now, the CRT (Cathode Ray Tube) controller 
is separate from the main circuit board of the PC. You’ll find this chip on the 
video board which is mounted in one of the computer’s expansion slots. Even 
though there are many boards that differ widely in their capabilities (monochrome 
display, color display, etc.), all video boards are based on the 6845 CRT controller. 
It produces a display on the monitor connected to the computer. The controller has 
several internal registers which control the output of the display. 


The Disk Controller 


This chip is also usually located on an expansion board. It is addressed by the 
operating system and controls the functions of the disk drive. It moves the 
read/write head of the disk drive over the disk, reads data from the disk and writes 
data to the disk. | 


The Math Coprocessors (8087/80287/80387) 


The 8088, 80286 and the 80386 are not capable of performing floating point 
arithmetic operations directly. There is a socket on the main circuit board of the 
PC for adding a special math coprocessor. The PC/XT uses the 8087, the AT the 
80287 and the new 80386 uses the 80387 coprocessor. 


While floating point arithmetic can be performed using software routines, a math 
coprocessor is up to 100 times faster. The 8087 and the 80287 can perform basic 
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math functions such as addition, subtraction, multiplication and division, as well 
as the trigonometric functions sine, cosine, etc. They can also compute square 
roots of numbers. 


In general, only a few application software packages support the math 
coprocessors. 
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The CPU and Memory 


While the chips described up until now are intelligent system components, 
memory is a passive element. Data can be stored and later retrieved from memory. 
Each memory location is used to store one byte (8 bits) of data. Memory locations 
are identified by a unique address, starting from zero. 


The support chips communicate with memory using a bus or path over which the 
electronic signals travel. 


Address bus 


The address bus carries the number of the memory location to be accessed. The 
signals on the bus represent a binary number whose value indicates the memory 
location for access. Since only those memory locations represented on the address 
bus can be accessed, the number which make up the bus lines determine the 
number of addressable memory locations. 


The PC/XT has a 20-bit address bus and can address a maximum of 2” (about 1 
million) different memory locations. The AT has a 24-bit address bus and can 
address more than 16 million memory locations. 


Data bus 


Once the bus knows the address of the memory location to be accessed, data can be 
transferred between the individual chips and the memory location over the data bus. 
The number of lines in this circuit determine how many bits are transferred to or 


from memory simultaneously. 


The PC/XT has 8 lines so it can transfer one byte at a time. However, since the 
8088 is a 16-bit processor, 16-bit data must often be transferred. There aren’t 
enough lines to transfer 16-bit data, so the system divides a 16-bit data item into 
two 8-bit numbers. These two 8-bit data bytes are transferred one after the other 
along the bus. 


The 8086 and 80286 processors can transfer 16 bits simultaneously over their 16- 
bit-wide data buses. This is one reason why the AT executes programs faster than 
the 8088 processor. The 80386 processor can transfer 32 bits at atime. — 


Word storage 


16 


All members of the Intel 80xx processor family share the same method of storing 
words (16-bit data) in memory. The lower numbered memory location contains 
bits 0-7 (the low byte) and the higher numbered memory location contains bits 8- 
15 (the high byte). For example, if you store the word 3F87H starting at address 
0000:0400, memory location 0000:0400 accepts the low byte 87H and memory 
location 0000:0401 accepts the high byte 3FH. 
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Two details were left out of the discussion of memory so far: 


1.) The processor doesn’t care if a memory address is located in a RAM chip 
or a ROM chip. The main difference between RAM and ROM lies in the 
fact that you can’t write or store new data into ROM (hence its name: 
Read Only Memory). 


23) The addressable space of the microprocessor (1 megabyte) is allocated into 
16 storage segments of 64K each. This is an almost universal division 
used on IBM PC/XTs and most compatible machines. 


| 15 [F000:0000-F000:FFEF BIOS ROM 
[14 JE000 :0000-ROOO: FFF [ROM cartridge —-s—~“‘;™;!CS 
TSB OOOLOOOO-BOOOLEEFFT ROW soe 


1CQ00 :0000-CO00:FFFF J|additional BIOS ROM 
aes % Se O=LereXeATelolekS BOUL eee Lyideo 5 28-5 
("313000 50000=S000 FFF TRAN up to 640K RA ie to 6 ss 
EE: 
F-90500 0000= OOO FFEF_T RAM io ee BB 
ee 


| 6 16000: 0000-6000 SF FEF | 

22000 0000-5000 FREE RAM up to 384K 

|__ 4_ 1 4000:0000-4000:FFFF_| RAM up 

—"5-T5000: OOOO=SOOOS FEF [REM up to 25ek SY 

a ee eR UD bo 
000:0000-1000 


0000 :0000-0000:FFFF } RAM p to 64K, CPU vector table, 
DOS & BIOS variables 


Memory allocation 


The first 10 memory segments are reserved for the main RAM memory, limiting 
maximum RAM to 640K. A computer’s memory size may differ from one PC 
manufacturer to another but has at least 64K installed in segment 0. If you install 
additional RAM, its first memory address must immediately follow the last 
existing memory address, since no gaps may exist betweer individual RAM 
memory segments. Memory segment 0 has a special role since it contains 
import: «data and operating system routines. 


Memory segment A follows the RAM memory. In this case, an EGA (Extended 
Graphics Adapter) is installed. This board uses the memory for the screen display 
in different graphic modes. 


Memory segment B is reserved for a monochrome or color graphics board. They 
share the segment as screen memory. The monochrome board uses the lower 32K 
and the color board uses the upper 32K. Each board uses only as much memory as 
it needs for the screen display. The monochrome board uses 4K; the color board 
uses 16K because of the additional color capabilities. 


17 


2. The PC's Brain PC System Programming 


The next memory segment contains ROM beginning at segment C. Some 
computers store the BIOS routines which aren’t part of the original BIOS kernel at 
this location. For example, the XT uses these routines for hard disk support. Since 
this area isn’t fully utilized, it is possible that BIOS routines supporting future 
hardware enhancements will also be placed in this memory range. 


ROM cartridges 
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Segments D and E are reserved for ROM cartridges. These cartridges extend the 
computer with certain ROM routines. The PC has rarely used them and the area 
usually remains unused. 


Segment F contains the actual BIOS routines, the system loader and the ROM 
BASIC available on many computers. 


Chapter 3 


Introduction to Interrupts 


This chapter presents a view of interrupts, which are vitally important to the 
operation of the 8088 processor. An interrupt is a signal from a peripheral device 
or a request from a program to perform a specific service. When an interrupt 
occurs, the currently executing program is temporarily suspended and an interrupt 
routine begins execution to handle the condition that caused the interrupt. 


Program Interrupt routine 


Save register contents 


Restore register contents 
IRET 


Program interrupt 


Interrupt 
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When a program is suspended, the processor saves the contents of the CS and IP 
registers on the stack, and begins the interrupt routine. After the interrupt routine 
has completed its task, it issues the IRET (Interrupt RETurn) instruction which 
restores the contents of the CS and IP registers from the stack, thus resuming the 


program. 


The interrupt routine saves and restores contents of the other registers before 
returning to the interrupted program. 
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The Structure of the Interrupt Vector Table 


So far we’ve talked about a single interrupt and a single interrupt routine. In fact, 
the 8088 has 256 possible interrupts numbered from 0 to 255, not just one. 


Each interrupt has an associated interrupt routine to handle the particular condition. 
To organize the 256 interrupts, the starting address of the corresponding interrupt 
routines are arranged in the interrupt vector table. 


When an interrupt occurs, the processor automatically retrieves the starting address 
of the interrupt routine from the interrupt vector table. 


The starting address of each interrupt routine is specified in the table in terms of 
the offset address and segment address. Both addresses are 16 bits (2 bytes) wide. 
Therefore each table entry occupies 4 bytes. The total length of the table is 256*4 
or 1024 bytes (1K). 


Interrupt Purpose 


number: 
0000: 003FE ce al 
0000:003FC | IP | 
0000:000E . 
0000:000C 3 Breakpoint 
0000:000~A 
0000:0008 2 NMI 
0000:0006 
1 Single-step 
0000:0004 
0000:0002 a 
0 Division by 0 
0000: 0000 


Interrupt vector table 


The table itself is located in memory from 0H to 3FFH. Since the interrupt’s 
number is the same as the table entry for the corresponding interrupt routine, the 
interrupt routine address for interrupt 0 is the zero table entry in locations OH-3H. 
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Memory locations 4H—7H contain the address for the interrupt routine for 
interrupt 1, etc. The last interrupt, interrupt 255, occupies the end of the tabie at 
locations 3FCH—3FFH. 


To calculate the starting address of an interrupt, simply multiply the interrupt 
number by four. 


Advantages 


An advantage of using the interrupt vector table is that it’s easy to change an entry 
in the table to the starting address of a user-written interrupt routine. This makes a 
new interrupt routine available to any program which can invoke the routine 
simply by executing the corresponding interrupt instruction. 


The next section explains the different types of interrupts and how they are used in 
the system. 
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Interrupt Types 


Until now, we haven’t talked about different types of interrupts. There are two 
major types of interrupts—hardware interrupts and software interrupts. 


The figure below shows the different interrupt types. 


Software Hardware 
interrupt interrupt 


System fuser [Internal] [Externar 
[interrupts | jinterrupts — 


Interrupt types 


Software Interrupts 


A software interrupt is an interrupt called by the INT instruction in a machine 
language program. The INT instruction includes the number of the interrupt to be 
signalled. For example, the instruction to call interrupt 5, which sends a hardcopy 
of the current screen to the printer, appears as INT 5. The INT instruction allows 
you to call any one of the 256 interrupts. 


Software interrupts make it possible to use many of the basic operating system 
services from either the assembler (or machine language) level or from many of the 
higher level languages which support interrupt processing. 


Hardware Interrupts 


A hardware device such as a disk drive or keyboard can trigger a hardware interrupt. 
This is a simple and efficient mechanism for handling events which require 
attention. 


One example is the keyboard. When you press or release a key, interrupt 9 (the 
keyboard interrupt) is signalled. The standard DOS interrupt routine responds by 
placing the character value corresponding to the key that was pressed into the 
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keyboard buffer following any value which may have been previously there. If the 
keyboard buffer is full, the routine generates a short beep. As in any other 
interrupt, the original program continues after the completion of the interrupt 
routine. 


Maskable interrupts 


This interrupt is designated as an external hardware interrupt, because it was 
triggered by an external device. For these interrupts, a distinction is also made 
between maskable and non-maskable interrupts. The keyboard interrupt just 
described belongs in the maskable interrupt category. You can mask (disable) this 
interrupt by using the assembler instruction STI (SeT Interrupt flag). If you mask 
interrupt 9H, the keyboard ignores any characters you type. To reverse this 
condition, use the CLI instruction (CLear Interrupt flag) to re-enable the interrupt. 


Non-maskable interrupts 


In contrast, a non-maskable interrupt cannot be disabled by the STI instruction. 
One example is interrupt 2. This interrupt indicates an error in the PC’s memory. 
It displays a message on the screen that one or more of the RAM chips is defective 
and should be replaced. 


The last interrupt type to be described is the internal hardware interrupt. The 
processors on the main circuit board of the PC trigger this interrupt. One example 
is interrupt 8 which is designated as a timer interrupt. The timer triggers this 
interrupt at a rate of 12.8 times per second. It also disables the disk drive motor if 
no disk access is in progress. 
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3.3 Interrupts at a Glance 


The tables here show the significance which these interrupts occupy in the control 
and use of the PC. The next few chapters explain these interrupts in more detail. 


CPU: Division by zero 

CPU: Single step 

CPU: NMI (Error in RAM chip) 

CPU: Breakpoint 

CPU: Numeric overflow 

Hardcopy 

Unknown instruction (80286 only) 
reserved 

IRQO: Timer (Call 18.2 per/sec.) 
IROL: Keyboard 

IRQ2: Second 8259 (AT only) 

IRQ3: Serial interface 2 

IRQ4: Serial interface 1 

IRQ5: Hard disk 

IRQ6: Diskette 

IRQ7: Printer 

BIOS: Video functions 

BIOS: Determine configuration 

BIOS: Determine RAM storage size 
BIOS: Diskette/hard disk functions 
BIOS: Access to serial interface 
BIOS: Cassette/enhanced functions 
BIOS: Keyboard sensing 

BIOS: Access to parallel printer 
Call of ROM-BASIC 

BIOS: System boot (ALT+CTRL+DEL) 
BIOS: Read time/date 

Break key not activated (not CTRL-C) 
called after every INT 08 

Address of the video parameter table 
Address of the disk parameter table 
Address of the character bit pattern 
DOS: Terminate program 

DOS: Call DOS function 

Address of DOS end of program routine 
Address of DOS CTRL-BREAK routine 
Address of DOS error routine 

DOS: Read diskette/hard disk 

DOS: Write diskette/hard disk 

DOS: End Prg., remain resident 
Reserved for various, non- 
documented DOS functions 

BIOS: diskette functions 

Address of hard disk table 1 
Reserved 


Address of hard disk table 2 
can be used by application programs 
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12¢c 


1A0 


1c0 
1c4 
1c8 
Ice 
1D0 
1v4 
1D8 
1DC 
1E0 


200 


3C4 


19F 


1BF 
LE3 
C7 
1CB 
1CF 
1D3 
Ibi 
1DB 
1DF 


IPE 


3ac3 


_ 128 ~ 12B 


Alarm time reached (AT only) 


Can be used by application programs 


for any purpose 


Unused 


IRQO8: 
TRQO9: 
IRQ10: 
TROIS 
IRQ12: 
LROILS3: 
IRQ14: 
IRQ15: 
Unused 


Realtime clock (AT only) 
(AT only) 

(AT only) 

(AT only) 

(AT only) 

8UZ8/ NMI (AT only) 
Hard disk (AT only) 

(AT only) 


Used by the BASIC 
interpreter 


Unused 


General overview—interrupts 
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Chapter 4 


Using Interrupts from High 
Level Languages 


The assembly language programmer can invoke an interrupt by loading the 
parameters required by the interrupt routine into designated registers and executing 


the INT instruction. Although these capabilities aren’t available in all higher level 


languages, some languages such as Turbo Pascal®, Turbo C® and Microsoft C® 


have built-in functions, procedures or subroutines to call the interrupt. 


A BASIC programmer can call an interrupt using a short assembly language pro- 


gram. You'll find an example of this in Section 4.1. 


This chapter provides information on calling interrupts from Pascal, BASIC and 
C. Each describes how interrupts can be called in the particular language and the 
rules the programmer must observe. Each section concludes with a short 


demonstration program. 


Read through the section devoted to the language with which you feel most 
comfortable. A comparison of the three sample programs could be interesting for 
those of you who wish to compare the similarities and differences in the three 


languages. 


The programs are only examples. Experiment as much as you want—you won’t 


damage your computer if you change them a little. 
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Interrupt Calls from BASIC 


The two most commonly used BASIC interpreters are BASICA (from IBM) and 
GW-BASIC (from Microsoft). This book refers to GW-BASIC, since it can be 
used on IBM PCs as well as any compatible PC. The command sets of both are 
nearly identical. 


GW-BASIC does not have a function for calling interrupts. However, the CALL 
command can be used to execute a machine language program. You can also use 
the CALL command to pass certain parameters to the called program. The called 
machine language program must be located in the 64K used by GW-BASIC for 
program statements and variable storage. Because of this, the interpreter must be 
told to reserve part of program memory for the machine language routine. 
Otherwise the program or variables may overwrite the machine language routine, 
Causing a system crash. You can reserve memory directly when you call BASIC 
from the operating system. Enter the name GWBASIC followed by the /M: 
parameter. After the colon, enter the highest memory location you want used by 
BASIC. For example, since the sample program starts at memory location 60000, 
start the GW-BASIC interpreter as follows: 


gwbasic /m:60000 


This reserves the required memory space. Now you can place the machine language 
routine into memory by making it part of the current BASIC program and loading 
it into memory using a suitable subroutine. The current BASIC program must 
contain the following commands: 


60000 UHI KK KIKI KK KKK EEK AK IKKE KK KKK KKK KEK KKK EKER EKKAKEKKKKKKKKK 
60010 ‘'* initialize the routine for the interrupt call mt 
C0020 8 Bm a a re a 
60030 ‘* Input: none ay 
60040 ‘* Output: IA is the Start address of the Interrupt routine sla 
60050 CHK KK KKK KKEKKKKKKKKEKEKKEKKEKEKKEKKAKEKEKKEKEKKEKKKEKEKKKEKKKKKEK 
60060 ' 

60070 IA=60000! ‘Start address of the routine in the BASIC segment 
60080 DEF SEG ‘set BASIC segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke Routine 
60110 RETURN ‘pack to caller 
60120 '! 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108,255 


The DATA statements contain the machine language routine which performs the 
interrupt call. The routine is READ and then POKEd into memory. To start this 
routine at another memory location, change the value in line 60070. Remember 
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that the parameters used to start GW-BASIC must also be changed so that the 
routine cannot be overwritten by the variables of the program. 


To use the machine language routine to call an interrupt, this subroutine must of 
course be called first. The first line of the user program should therefore be: 


100 GOSUB 60000 


The actual program which calls the interrupt function during its execution can be 
stored between line numbers 100 and 60000. The following program line 
demonstrates how this can be done: 


200 CALL IA(INTNR%, AH%, AL%, BH%, BL%, CH%, CL%, DH%, DL%, DI&, SI%, ES%, FLAGS) 


The variables within parentheses are the variables passed to the assembly language 
program. All variables must pass true integer variables and not constants. The 
variable names mentioned above may be changed but their order must remain 
unchanged. Within your program they can have other names. 


The first variable in this example, called INTNR%, is the number of the interrupt 
you want to call. Be careful to specify the exact interrupt number. Also, avoid 
passing a variable which has not been initialized. Otherwise, you may call the 
wrong interrupt, which could lead to a system crash. The variables following 
INTNR% are copied into the processor registers of the same names. If a register is 
not used by an interrupt routine, you can pass any integer variable in the 
corresponding register variable. The value of the ES register is treated differently. If 
the value of ES% is -1, the contents of the DS register is copied to the ES 
register. 


Following the completion of the interrupt call, the values are returned in the 
designated register variables. 


This technique works only with half registers (AH, AL, BH...). It may be 
necessary to transform these half registers into a whole register. This can be done 
as follows: 


300 AX% = AH% * 256 + AL% 


On the other hand, a whole register can be split into two half registers with the 
following commands: 


410 AH% = INT(AX% / 256) 
420 AL% = AX% AND 255 


After calling interrupt functions, the carry flag in the flag register indicates if the 
called functions were executed correctly. In a BASIC program, it may be necessary 
to test the carry or zero flags. Since the content of the flag register is in the 
variable FLAGS% after the interrupt call, the status of individual flags can be 
inspected through this variable. This is possible with the following program 
Statements: 
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200 IF FLAGS%$ AND 1=0 THEN PRINT “CARRY-FLAG OFF" ELSE 
_ PRINT “CARRY-FLAG SET" 

210 IF FLAGS%$ AND 64=0 THEN PRINT "“ZERO-FLAG OFF" ELSE 
PRINT “ZERO-FLAG SET" 


Another problem with interrupt calling is passing variable addresses (e.g., character 
string output). BASIC stores this set of characters as a string. To determine the 
offset address of such a string (the segment address of all variables is constant), use 
the VARPTR function. The LO and HI byte of the offset address can be determined 
with the following two program lines: 


300 LO=PEEK (VARPTR (STRING NAME) +1) ‘LO-Byte of the Offset address 
310 HI=PEEK (VARPTR(STRING NAME) +2) ‘HI-Byte of the Offset address 


Garbage collection 
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These addresses should be determined at the beginning of a BASIC program as well 
as immediately before each interrupt call, since BASIC frequently performs garbage 
collection (removing unused variables and junk data). Garbage collection frees up 
variable memory, rearranges remaining data in memory and changes addresses. If a 
string address is determined at the beginning of a program, it may change several 
times before the interrupt call is made. 


Remember to include an end marker (“$” or a CHR$(0)) at the end of the string 
(BIOS and DOS functions expect one of these). 


Note: Before copying this subroutine and trying it, we have a small 
suggestion. During your first attempts something will probably go 
wrong. This is perfectly normal, and you can even expect the 
computer to crash a couple of times. Save programs 
frequently...especially before running the program. This way, you 
won’t have to type in the program again from the beginning. 


Here is a short sample program which uses the subroutine described above to 
display text on the screen with function 9 of interrupt 21H. 


100 CHK KKK KR KKK KKK KKEK KEK KKK KKK KKK KKKEKEKKKK KKK KEKE KEKEAKKKKKKKKKEKKKEKK 


NE 9 es INTDOSB ae 
VDE We ne nme wr ne me oe a te a cae ee ee ee cae me we me a se ee ee ee ee ee x 
130 '* Assignment : outputs as an example of an Interrupt = 
140 '* a String through a DOS function on ws 
150 ** the display screen = 
160 '* Author : MICHAEL TISCHER 
170 '* developed : 07/30/87 s 
180 '* last Update : 04/08/89 ss 


190 KK KKK K KK KKK KEK KKKKK KKK KEKE KKK KKK KE KKK KKKEKKKKKKKKEKKKKKKKKKKKKKKS 
200 ! 

210 CLS : KEY OFF 

220 PRINT"NOTE: This program can only be started if the GWBASIC was " 
230 PRINT"started from the DOS level with the command " 

235 PRINT“<GWBASIC /m:60000>." 

240 PRINT : PRINT"If this is not the case, please input <s> for Stop." 
250 PRINT"Otherwise press any key..."; 

260 AS = INKEYS : IF AS = “s" THEN END 

270 IF AS = “" THEN 260 

280 PRINT 

290 GOSUB 60000 ‘install function for interrupt call 
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300 TS = CHRS$(13) + CHRS$(10) + “this text was output through " 
305 T$ = T$ + “Function 9 of Interrupt 21H...$" 


310 INR% = &H21 ‘Number of interrupt to be called 
320 FKT% = 9 ‘Number of functions to be called 
330 OFSLO% PEEK (VARPTR (TS) +1) 'LO-Byte Offset address to the String 


340 OFSHI% = PEEK (VARPTR (TS) +2) ‘HI-Byte Offset address to the String 
350 CALL IA(INR%&, FKT%, 2%, 2%, 2%, 2%, 2%, OFSHI%, OF SLO%, 2%, 2%, 2%, Z%) 


360 PRINT : PRINT : PRINT ‘output three blank lines 
370 END 

380 ! 

60000 CW HMM KKK KKK KKK KKK KKK KKK KKK HK KKK KKK KKK KKK KKK EKKAKKKKKEKEKKKKEKEKES 
60010 ‘* initialize the routine for the interrupt call ia 
60020 § 8 —— ~~~ nn rn rn nn rr is 
60030 ** Input : none = 


60040 '* Output: IA is the Start address of the Interrupt routine * 
60050 UKM KHK KKK KHAKI K KKK KKEKKKKHKEKKKKKKKKKKKKEKKEKKEEKKEEKKEKKEEAKS 
60060 ' 

60070 IA=60000! ‘Start address of the routine in the BASIC segment 
60080 DEF SEG ‘set BASIC segment 
60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke Routine 

60110 RETURN ‘back to caller 
60120 ' 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 

60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 

60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 

60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 

60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 

60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 

60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 

60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 

60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 

60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 

60230 DATA 202, 26, 0, 91, 46,136, 71, 66, 233,108,255 


How it works 


The program is composed of separate parts. Lines 210-290 call the subroutine to 
initialize the machine language function for the interrupt call. Then the individual 
variables for the interrupt call are loaded. T$ accepts the string to be output. 
CHR$(13) and CHR$(10) print a blank line before the output of the actual text. 
This text ends with the “$” character because the DOS function which outputs the 
string expects this character as an end marker (it will not display this character). 
INR% and FKT% contain the interrupt number and the function number to be 
called. Besides these two variables, the variables OFSLO% and OFSHI% contain 
the offset address of TS. 


The CALL command (line 350) calls the interrupt. The first variable passed is 
INR% with the number of the interrupt to be called. Then follows FKT%, which 
transfers to the AH register before the interrupt call and informs interrupt 21H of 
the function number to be called. Several Z% variables follow. These act as 
dummy variables for all registers which have no special significance to the 
function which is called. The content of Z% is unimportant. The content of the 
register into which it is copied is irrelevant for the called function. After the Z% 
variables, which determine the contents of the AL, BH, BL, CH and CL registers, 
follow the variables OFSHI% and OFSLO%, which set the offset address of the 
string in the DX register. The remaining register contents are unimportant for the 
function call and are filled with Z%. 
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To permit the DOS function which is called to output the text, its offset and 
segment address must be known. This address is expected in the DS register and 
will be set automatically by GW-BASIC. 


To conclude this section, here is the listing of the assembler program that we just 
used to call an interrupt. 


PR ARKKKKKKKEK KEK KEK KKK KKK KK KKK KKK KKK KEK KKK KKK KEKE KK KKK KKK KEK KKK KKKHKKKKKKKKK 


;* BASINT.ASM: This routine offers the capability of = 
7* calling any interrupt from BASICA or * 
7* GWBASIC x 
al * 
oes sm’ ams im cui cnn ume css ni “eb sea cm x's Ss Sou sis mse som ao xs 'cbSinw Se ere icc sans cS Ss ms ib anh ub mb ems ‘ile Gch cain‘ ‘um cos" SS Gem SxS‘ kk 
;* Call: id 
;* CALL ADR (INTNR%, AH, AL%, BH%, BL%, CH%, CL$, DH, DL%, DI%, SI%, ES%, FLAGS%) * 
eRe sda Sis Vat epi cea: ms me cas wi ue i mus Sys tks sl, ‘nnn cams cnn es ls coms nis sa en mcs es cis ‘ab cay Ss So mn i ce Sy ‘as ‘nek Gs ned amd Goel inci es ence is" cae | kk 
7;* On passing control to the machine language program BASIC x 
7* deposits the variables on the following positions of the stack * 
7* INTNR& = SP+30 AH% = SP+28 AL% = SP+26 BH% = SP+24 x 
7* BLS = SP+22 CH% = SP+20 CLS = SP+18 DHS = SP+16 il 
7;* DL% = SP+14 DI% = SP+12 SI% = SP+10 ES% = SP+8 x 
7* FLAGS$ = SP+6 bs 
oe ce a em Gases Ges cinta cen ck mss Sane’ sn ccc ms seme sada ni vn sos aan assess aan es meas’ na cin cei eis cms‘ i ‘Sp uh nin’ cm’ eis ie lh i es ea kk 

k 


7* for ES the value -1 is passed, then ES is set to DS 
PERAK K EKER K KKK KE KKK KKK KKK KEKE KEKE KEK KEKEK KEKE KER KKKEEK KEKE KEKKKEKEKKKE | 


code segment 


assume cs:code,ds:code, es: code, ss: code 


7>= the Routine. for Interrupt.call -=—=<-s-s<—=-s-s=s4=-4--$55s4-5--=- 


basint proc far 7;GW expected during CALL far procedure 
push bp 7;GW base pointer saved 
mov bp,sp 7send SP to BP 
push ds 7GW dta segment stored 
push es 7GW extra segment saved 


mov si, [bp+30} 
mov ax, [si] 
call set_intnr 


7Get address of variable INTNR 
7Move content of this variable to AX 
7Store interrupt number 


ad 1 label near 7Address for SET_INTNR 
mov. si, [bp+12] 7Get address of DI% variables 
mov di, [si] 7;Move content of variables to DI 
mov si, {bp+8] 7Get address of variable ES% 
mov ax, [si] s;Move content of variable to AX 
cmp ax,-1 7was -1 passed? 
jne setes 7;No --> set ES 
mov ax,ds 7;Set AX to DS and thereby ES = DS 
setes:;: mov eS,ax ztransfer AX to ES 
mov si, [bp+28] 7Get address of variable AH% 
mov ah, [si] 7Move content of variable to AH 
mov si, [bp+26] 7Get address of variable AL% 
mov al,([si] 7Move content of variable to AL 
mov si, [bp+24] 7;Get address of variable BH% 
mov bh, [si] 7Move content of variable to BH 
mov si, [bp+22] 7Get address of variable BL% 
mov bl,[si} 7;Move content of variable to BL 
mov si, {bp+20] 7Get address of variable CH% 
mov’ ch, [si] ;Move content of variable to CH 
mov si, [bp+18] 7Get address of variable CL%& 
mov cl, [si] *Move content of variable to CL 


ad 2 


basint 


;Get address 


4.1 Interrupt Calls from BASIC 


of variable DH$% 


;Move content of variable to DH 


7;Get address 


of variable DL& 


sMove content of variable to DL 


7;Get address 


of variable SI% 


sMove content of variable to SI 
;Store base pointer 


;Address for 


SET INTNR 


7;Call interrupt 


;Replace base pointer 


7Store SI 


;Store flag register 


7Get address 


of variable DI% 


sMove content of variable to DI 


7Get address 
;Store AH in 
;Get address 
7;Store AL in 
7;Get address 
;Store BH in 
;Get address 
;Store BL in 
7;Get address 
;Store CH in 
;Get address 
;Store CL in 
;Get address 
:Store DH in 
7;Get address 
;Store DL in 
7;Get address 
stransfer ES 


of variable AH% 
this variable 
of variable AL% 
this variable 
of variable BH% 
this variable 
of variable BL% 
this variable 
of variable CH% 
this variable 
of variable CL& 
this variable 
of variable DH% 
this variable 
of variable DL% 
this variable 
of variable ES% 
to AX 


;Store ES (AX) in this variable 
;Move flag register from stack to AX 


7;Get address 
7; Store FLAGS 


of variable FLAGS$% 
in this variable 


;Move DI register from stack to AX 


7Get address 


of variable SI% 


;Store SI (AX) in this variable 


;Get GW extra segment back 


7;Get GW data 


segment back 


;Return GW base pointer 


sAddresses of variables on the stack 
sare no longer needed 


set_intnr 


set_intnr 


;stores the interrupt number 


cs: [bxtad_2-ad 1+1],al 


mov. si, [bp+16] 
mov dh, [si] 
mov si, [bp+14] 
mov dl, [si] 
mov si, {bpt10} 
mov si, [si] 
push bp 

label near 

int 21h 

pop bp 

push si 

pushf 

mov si, [bp+12]} 
mov [si],di 
mov si, [bpt28] 
mov [si],ah 
mov si, [bp+26] 
mov [si],al 
mov si, [bp+24] 
mov [si],bh 
mov si, {bp+22] 
mov [si],bl 
mov si, [bp+20] 
mov [si],ch 
mov si, [bp+18] 
mov [si],cl 
mov si, [bp+16] 
mov [si],dh 
mov si, {[bpt+14] 
mov [si],dl 
mov si, [bp+8] 
mov ax,es 

mov {[{si],ax 
pop ax 

mov si, [bpté] 
mov [si],ax 
pop ax 

mov si, [bpt+10] 
mov [si],ax 
pop es 

pop ds 

pop bp 

ret 26 

endp 

proc near 

pop bx 

mov 

jmp adil 

endp 

ends 

end 
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Some brief notes on this program follow for those not familiar with the calling 
and linking of assembly language programs in GW-BASIC: The program first 
pushes the base pointer on the stack since it will be reset by the next instruction. 
During re-entry into GW-BASIC, the base pointer must have the value it had 
during the call of the routine. Then the base pointer is set to the value of the stack 
pointer for access to data on the stack. This is necessary for GW-BASIC to pass 
the BASIC variables named in the CALL command to the stack. In the next step, 
the DS and the ES registers are stored on the stack, because their content may 
change during execution of the routine and must be preserved for return to GW- 
BASIC. 


Now the routine can read in the variables and set the various processor registers. It 
is important to note that the stack does not contain variable contents, but their 
addresses relative to the DS register. Because of this, the address of the variable 
must be loaded first and then the relative value of this address. 


Which addresses contain the addresses of the individual variables stored on the stack 
can be determined from the header of the assembly language routine. First you 
must determine the number of the interrupt to be called. This value must be treated 
in a different manner than the other variables on the stack because it isn’t passed in 
one of the processor registers, but is a part of the INT instruction which calls the 
interrupt. It is indicated as a byte following the code of the INT instruction (CDH). 


To set the interrupt number, the number to be passed must be stored following the 
CDH code of the INT instruction. This creates a small problem since this routine 
can be POKEd by the BASIC program into any memory location. Because of this, 
the address of the INT instruction depends on the current starting address of the 
routine instead of remaining constant. The routine doesn’t know where the INT 
instruction is located. 


A small trick can be used to help here. The routine does not know where it is 
stored, but the processor knows the location of the INT instruction (it has to 
know, otherwise it couldn’t execute the routine). The subroutine SET_INTR is 
called after the interrupt number is loaded into the AX register. The processor, as 
in any CALL instruction, stores the address where the program execution is to 
continue on the stack, before calling any subroutine. This is the instruction which 
precedes the label AD_1. 


Subroutine SET_INTR gets the address of AD_1 from the stack. While the address 
of the INT instruction is still not known, the distance between AD_1 and the INT 
instruction remain constant, the address of the INT instruction can be calculated 
and the interrupt number can be stored following the instruction. The task ends and 
the routine returns to the main program (to the label AD_1). 


The rest of the routine consists of repeating instructions which determine the 
contents of the different variables and pass them to the corresponding processor 
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registers. The value for the ES register is given a special test: if it is equal to -1, 
the value of the DS register is copied to the ES register. 


After all registers are loaded, the interrupt is called and the contents of the 
processor registers are transferred back to the corresponding BASIC variables. The 
last step is to restore the contents of all registers which had been saved on the 
stack. Finally control returns to GW-BASIC. 
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4.2 Interrupt Calls from Turbo Pascal 


INTR 


Calling interrupts from Turbo Pascal is very easy. Throughout this book we'll be 
using Turbo Pascal Version 4.0. 


Turbo Pascal uses the INTR procedure. Since this parameter can accept any value 
between 0 and 255, all available interrupts can be called. 


MSDOS 
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A special form of this INTR procedure is the MSDOS procedure. It is called in a 
manner similar to INTR: 


MsDos( Regs:Registers ); 


The InterruptNumber parameter needed by Turbo Pascal Version 3.0 isn’t required 
in this procedure since it always calls interrupt 21H, through which almost all 
operating system functions can be called. 


In both procedures, the parameter register is a record type which holds the contents 
of the registers to be passed. These are copied into the registers before the interrupt 
call. 


The DOS unit contains the parameters for the type called Registers: 


type Registers = record 
case integer of 
QO : (AX, BX, CX, DX, BP, SI, DI, DS, ES, Flags : word); 
1 : (AL, AH, BL, BH, CL, CH, DL, DH : byte); 
end; 


Once the DOS unit has been included in a Turbo Pascal source code, the var 
statement can be used to define the register variables under the name Regs: 


var Regs : Registers; 


Now Turbo Pascal can easily communicate with the following processor registers: 


Regs.ax, 
Regs.bx, 
Regs.cx, 
Regs.ah, etc. 


You then pass the values to the registers through standard assignments. For 
example: 


Register.ax := 254; 


The same method is used with all other registers. 
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Unfortunately, the contents of the half registers AH, AL, BL, etc. can’t be defined 
this way. In this case, a trick can be used by defining the half registers as normal 
integer or byte variables and then merging them together into a whole register. 


In the case of the AX register, this could be done as follows: 


var al, 
ah : integer; 


Register.ax := ah shl 8 + al? 


In this statement, the AX register is assigned value composed of the sum of the 
AH register multiplied by 256 (shifting a variable left by 8 places is equivalent to 
multiplying it by 256) and the AL register. 


If you must do this repeatedly in a program, it would be useful to define a small 
function for this: 


function WholeRegister(Lo, Hi : integer) : integer; 


begin 
WholeRegister := Lo + Hi shl 8; 
end; 


Instead of the above, the following could be written: 


Register.ax := WholeRegister(al, ah); 


Before calling the interrupt, you must first specify the interrupt value in the 
register. The contents of all other registers are unimportant here. If the called 
interrupt returns values to the calling program through registers, they can be 
examined by looking at the individual components of the variable register. 


Sometimes individual flags pass information from the interrupt to the calling 
program. In most cases, the Carry flag serves this purpose. If an error occurs 
during the execution of an interrupt, the flag is set. 


To test for a set flag, the following Pascal statements are used. They return TRUE 
or FALSE as a result depending on whether the corresponding flag was set or not. 


carry flag: (register.flags and 1) 
zero flag: (register. flags and 64) 
sign flag: (register. flags and 128) 


Often the address of a variable (usually a text buffer) must be passed to an 
interrupt. In this case the Turbo functions Ofs and Seg are used to obtain the offset 
or segment addresses of a variable. The name of the variable whose address should 
be determined is passed to both functions as the argument: 


ofs (variablename) 
seg (variablename) 


Turbo Pascal uses a different format than DOS and BIOS for string storage, 
especially for text buffers (mostly variables of type string). 
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These formats are illustrated below. 


TURBO PASCAL 


2 [menace *—-No end of string marker 
ee 


DOS & BIOS 


noN 


String length 


BIOS (and often in DOS) 
DOS 


— End of string marker 


No string length parameter 


String storage - Turbo Pascal and BFOS-DOS 


To convert a Turbo Pascal string into DOS or BIOS format, an end character 
(ASCII code 0) or the dollar sign “$” (ASCII code 36) is appended. Which of these 
two characters you should use for indicating the end of the string is described 
during the discussions of individual interrupts. Regardless of which format you 
use, the characters appear as in either of the following commands: 


string := stringt+#0; 
string := string+#36; 


The address returned by the Ofs function plus 1 must be passed to the interrupt, 


otherwise the byte which indicates the length of the string is accepted by the 
interrupt as its first character. 


Here is the sample program. Just like the example in Section 4.1, it displays text 
on the screen using function 9 of interrupt 21H: 


[RTO III IIR OIRO RIOR IIT OR RIOR RK IIT TR TOK KIA KK IIH } 


oe INTDOS *) 
{ *------------------~----~-----+----------------- -- +--+ -- +--+ + --- == *} 
{* Task : aS an example this interrupt call outputs *} 
{* a string through a function of DOS on *} 
t* the display J 
| 8a eee Geese ee ae ee eee taco een eee ek Beek ne co eee *} 
{* Author : MICHAEL TISCHER *} 
{* developed : 07/30/87 ~ 
{* last update : 05/04/89 a 


{ BARKER HEIR KKK KKK KKK KHIR KKK RHR K HAHAH K RAK KK HRK KAKA KARR HER HAK EK K | 


program INTDOSP; 


Abacus 4.2 Interrupt Calls from Turbo Pascal 


Uses Dos; 
var Regs : Registers; { Register variables for interrupt call} 
Text : string[128]; { accepts the output text } 


{FIR II IR III I KI IK TKK KK IK IKK KKK KK IKK KKK IKK ERR RK KKK KAIRIE KKK KKK EK KKK | 
{* MAIN PROGRAM *} 
{ RRR R KKK KKK KKK RK KKK RK KERR KKK IKK KKK KKK KKK KKK KKK KEK KEKE KKK KEEKEKKEKKKK EE | 


begin 


Text := #13#10'this text was output with Function 9 of DOS-—'+ 


‘interrupt Zin ...*#iS#107°S'; 
Regs.ah := $09; { Function number 9 in the AH-Register } 
Regs.dx := Ofs(Text)+1; { Offset address of the text } 
Regs.ds := Seg(Text); { Segment address of the text } 
MsDos (Regs) ; { Call DOS-Interrupt 21(h) } 
end. 


The variable TEXT contains the text to be displayed. The sequence “#13#10” 
places the ASCII code 13, followed by ASCII code 10, at the beginning and the 
end of the text, creating a blank line before and after the text. The last character is 
the ““$” character which indicates the last character of text to DOS. 


The number of the function being called (9) is copied to the AH register. Since 
Turbo Pascal doesn’t allow access to the AH register alone, the entire AX register 
must be addressed. The value 0 is loaded into the AL register, but any other value 
could be entered into this register since its content has no significance to the called 
function. As a last step, before calling interrupt 21H using the MSDOS procedure, 
the segment address of the string is placed in the DS register and the offset address 
in the DX register. 
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Interrupt Calls from C 


The C language is the language of choice for most developers. Since it was 
originally designed for operating system development, C has provisions to include 
machine language routines, which is a benefit within the scope of this book. 


The standard libraries of both the Microsoft C and Borland Turbo C compilers have 
a number of functions for calling interrupts. 


The following functions are of interest to us in this book: 


int 86 

int86x 
intdos 
intdosx 
segread 


All functions and applicable data structures are declared in the DOS.H library file. 
A program which wants to access one of these functions must therefore link the 
file to the current program using the #include preprocessor command. 


The three structures WORDREGS, BYTEREGS and SEGREGS pass register 
values. WORDREGS contains the whole registers AX, BX, CX, DX, SI, DI and 
the Carry flag. On the other hand, BYTEREGS contains the half registers AH, 
AL, BH, BL, CH, CL, DH and DL, while SEGREGS represents the segment 
registers DS, CS, SS and ES. 


The BYTEREGS and the WORDREGS structures are joined in the union REGS 
which lets the programmer work selectively with either half or whole registers. 


Using a variable of the type REGS (called register here for simplicity’s sake) gives 
us the following: 


union REGS register; 


This allows access to individual registers: 


AX: register.x.ax 
BX: register.x.bx etc. 
AH: register.h.ah 
AL: register.h.al 
BH: register.h.bh etc. 


The carry flag is represented by the variable register.x.cflag. If this variable is equal 
to 0, the carry flag remains unset. Any other value sets the carry flag. 


In the case of the segment register a representative variable can be defined as 
follows: 


struct SREGS SegRegister; 
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int86 


int86x 


The individual components of the variables SegRegister.ds, SegRegister.es, etc., 
correspond to the equivalent processor registers. 


The functions starting with the characters int all serve to call interrupts. The 
SEGREAD function reads the current contents of the segment register. 


The functions that call interrupts use different register variables for input to the 
interrupt routine, and output from the interrupt routine. There is an advantage to 
this method over returning information to the same regisier variabie in that ihe 
input information is not overwritten. 


Since the individual functions pass only the address of the variable representing the 
register and not the variable itself, it is possible to combine the input and output 
registers into a single variable. In this case, the address of one variable is provided 
for the variable representing the input and the output registers (this method is used 
in the sample program at the end of this section). 


Before calling the interrupt, the contents of the input variable are copied to the 
corresponding processor registers. Following the interrupt call their contents 
become the output variables. 


All interrupt functions return the content of the AX register as a result code after 
the interrupt call. 


Here are the details of the functions and their calls: 


The int86 function is called as follows: 


int86(IntNumber, InRegister, OutRegister) ; 


IntNumber is a variable or constant indicating the number of the interrupt to be 
called. InRegister and OutRegister contain the address of two (or one) variables of 
the REGS type. As the variable name suggests, InRegister contains the register 
contents before the interrupt call, and OutRegister contains the register contents 
after the interrupt call. 


The int86x function differs from the int86 function in that it requires an additional 
argument of the SREGS type. Its contents are copied into the segment register 
before calling the interrupt, but are not copied back following the call to the 
interrupt routine. 


The call of the function is as follows: 


int86x(IntNumber, InRegister, OutRegister, SegRegister); 
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intdos 


intdosx 
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The intdos and the intdosx functions differ from the two functions described above, 
in that the number of the interrupt to the call is not passed. As the names suggest, 
they call DOS interrupt 21H through which most DOS functions can be accessed. 


Only the addresses of the input and the output variables representing the processor 
registers are passed to the intdos function: 


intdos (InRegister, OutRegister); 


The intdosx function, like the int86x function, has an additional parameter for the 


segment register. The function call is as follows: 


intdosx (InRegister, OutRegister, SegRegister) ; 


So far you’ve seen how to call an interrupt from C and how to set the registers. 
You also have to determine the address of a variable. 


In C, you can easily determine the address of a variable. To do this, use the address 
operator &, which returns the offset address of any desired variable. Use the 
SEGREAD function mentioned above to determine the segment address of a 
variable. The address of a variable of the SREG type is passed to the function 
(using the address operator &) into which the content of the segment register can 
be copied. 


If, for example, the address of the variable SegRegister is passed to the function 
and the variable was previously defined by the command: 


union SREG SegRegister; 


Then the variable SegRegister.ds contains the segment address of the variable 
SegRegister, after calling the SEGREAD function. 


While C supports interrupt calls with numerous functions, the library of the 
Microsoft C compiler library does not have a function to return the contents of a 
memory location. Since such a function could be very valuable in some programs, 
the assembler program below contains the PEEKB and POKEB functions for 
inclusion in programs created with the Microsoft C compiler. PEEK returns the 
contents of a memory location (one byte), while the POKE function writes a one- 
byte value into a memory location. 


Note: If you use the Borland Turbo C compiler, you won’t need to use this 
program since the Turbo C library already contains the PEEK, 
PEEKB, POKE and POKEB functions. Because of this, linking the 
assembler program into the C example programs of this book is 
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unnecessary. Additional information is presented in the header of each 
program. 


If you are using the Microsoft C compiler, enter the following program with a text 
editor and save it under the name PEPO.ASM. It can then be assembled with: 


masm pepo; 

Here’s the program: 

PRAIRIE RE RR KKK KKK KR KEKE RK KKK KK KEKE KK EKER KKK EERE KEE 0 
7* P EPO “7 
ee a a cw a acs cs sec cs ees Sa cis och sa cass cad causa Sass cas ass wb tema cc Ss at ccs cc es ces sen com as ats as meme ss Sans a es ls Ses cles“ ls Wa eas dn se as Saas Nas la Us ee“ xs 
:* Task : Makes the PEEKB and POKEB function available for *; 
an inclusion in a C program sir 
os scsi cc's (St ‘ween ms es Ganesan mh ames ash i rasa ces sss Sis ame a ens im mc lms ues eis i Sv Sp aes im es wis cm tt nc cm es, cats ots so ts Ss ses is So io mw i cee a» 
7* Author : MICHAEL TISCHER *; 
al deve loped : 08/13/87 xs 
rs last Update : 04/08/89 me 
1 pea exis cs eh ek i Sey Sen ees as cy cus ein ees ses “Ss acs ens Sn cs cn ‘ies ses a ees ccs cil ae a en ee om ei nis ences "osc es cs es es tn cin cs eh snes cms eh tenth cca wa Gas Ss ns cok Ses Sil teed bald 
= assemble : MASM PEPO; xs 
FHKE IR HERR KER KK ERK EKER EREKERKEKK ERE KEKE K EKER EK EKER EREKREKEKEKKEKEKKEKEKKKK © 


s 
7 


IGROUP group text 7;Grouping of program segments 
DGROUP group const, bss, data 7;Grouping of data segments 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


public PeekB 7Functions become accessible to 
public PokeB yother programs 


CONST segment word public 'CONST' ;this segment accepts all constants 


CONST ends ;which are readable 
_BSS segment word public ‘BSS' ;this segment accepts all non- 
BSS ends zinitialized static variables 


_DATA segment word public ‘DATA' yall initialized global and 
_DATA ends ;static variables are stored in this 
7; segment 


_TEXT segment byte public 'CODE' ;the Program segment 


7;-—- PEEKB: read a byte from memory --~----3----3-3 93-99-99 
;-- call of C: int = PeekB(int Segment, int Offset) 


_PeekB proc near 


push bp ;store BP on the stack 

mov bp, sp ;transmit SP to BP 

push ds ;store data segment register 
mov ax, [bp]+4 sget first argument (Segment) 
mov ds,ax ;set as data segment 

mov bx, [bp]+6 7get second argument (Offset) 
mov al, [bx] ;read memory location 

xor ah,ah ;HI-byte of INT to 0 

jmp short fctend ;terminate function 


_PeekB ~~ endp 


;-- POKEB: write a byte into memory -~-------------~------------ 
;-- Call C: PokeB(int Segment, int Offset, short int Wert) 


_PokeB- proc near 


push bp 7store BP on the stack 
mov bp,sp ;transmit SP to BP 
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push ds ;store data segment register 

mov ax, [bp]+4 7Get first argument (Segment) 

mov ds,ax ;Set as data segment 

mov bx, ([bp]+6 7;Get second argument (Offset) 

mov al, {bp}+8 7;Get third argument (Value) 

mov [bx],al zwrite into memory location 
fctend: pop ds ;Return data segment register 

mov sp,bp 7Restore stack pointer 

pop bp 7Get BP from stack 

ret 7;Return to calling C program 


_text ends 7End of the program segment 
end z;End of the assembler source 


The example program below uses the two functions described above. This next 
program examines the model identification number or code of the PC and displays 
PC type on the screen using a DOS function: 


[RRR ERK RHA HK EKER KEKE KEIR EKER KK KEKE EKER E KKK KK EK / 


[? INTDOS aij 
SF aa a eB ne a a cat x/ 
ies Task : an example of an interrupt call, outputs */ 
i a string through a DOS function on */ 
7* the display screen bay 
/* a a a ts cs es ee a cs ees ee se fa ss nse Ss a ees es awe os Sa ee ed ee eh er a ws es ew a os Le ee es ea ce. x/ 
/* Author : MICHAEL TISCHER */ 
/* developed : 08/30/87 */ 
7% last update : 04/08/89 a7 
/* a a a ae eas ae ek eee a ons Se ae eke ee ee ee ea x /. 
7* (MICROSOFT C) wy 
i Creation : MSC INTDOSC my, 
[* LINK INTDOSC PEPO; */ 
{* Call : INTDOSC */ 
/* a a cs a i a a ai as ck sa a tc ese en cls dla es ie Ses an Se ene css ew er ae ee ed eee we Ge ec a/ 
/* (BORLAND TURBO C v2.0) xf 
7i* Creation : through the RUN command in the menu...or... *{ 
7” tec -K intdosc sd 
p= Call : intdosc is 


a 
[EKA K AKER KEK IKI II KKK HK K IK IKK IKK II IK III KKK KKK AKAIKE IKKE K / 


#include <dos.h> /* include header file x/ 
/* Microsoft C user must uncomment the following line Lad fe 
/* extern short int peekb(); /* PEEKB must be linked to */ 
/* Microsoft C object code */ 
[RIK IKK IRR IR KIKI II IK IK RHI II III IK ITI TI II IIH KRISTI KAA AAAI / 
[es MAIN PROGRAM */ 


[RRR IRI KK KIRK III IKI KKK KIKI KIKI KIKI KIKI IKK I KKK IIHR KI IKKE KER K / 
void main () 


{ 
static char AT[] "\r\nthis computer is an AT\r\n$"; 
static char XT[] = "\r\nthis computer is an XT\r\n$"; 
static char PC[} = “\r\nthis computer is an PC\r\n$"; 


union REGS Register; /* Register variable for interrupt call */ 


Register.h.ah = 9; /* Function number for output of string */ 
switch (peekb(OxF000, OxFFFE) ) /* detect model of PC */ 
{ 
case OxFE : Register.x.dx = (int) XT; /* Address of XT text */ 
break; 
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case OxFC : Register.x.dx = (int) AT; /* Address of AT text */ 
break; 
case OxFF : 
default : Register.x.dx = (int) PC; /* Address of PC text */ 
} 
intdos (&Register, &Register); /* Call DOS interrupt 21H */ 


} 


The main function defines three CHAR pointers which point to the text for each 
PC type. Each of them starts and ends with an ‘“\n” character. This creates a blank 
line before and after the text itself. 


In the first instruction of the main program the AH register is loaded with the 
DOS function number for string output on the screen. Then the model 
identification byte is read from memory location FOOO:FFFE using the PEEKB 
function. Depending on the value read, the offset address of the accompanying text 
is transferred to the DX register where it is expected by the interrupt 21H function. 


In addition to this offset address, the function also requires the segment address of 
the text in the DS register. Since the compiler automatically sets this register, you 
don’t have to be concerned with the segment address. The last instruction of the 
program calls the INTDOS function which in turn calls interrupt 21H with the 
registers which were defined earlier. 


The file header states how it can be executed: If you are using the Microsoft C 
computer, then it is important that you link the file with the previously assembled 
PEPO program so that the new program contains the PEEKB and POKEB 
functions. These can then be called from the C program. 


The integrated environment of the Turbo C compiler requires a different procedure. 
Compiler options must be set to default values except for under "code generation." 
You must set "default char type" to "unsigned", then select Run from the menu. 
The options file appears on the disk under the filename INTBSPC.TC. 


A small comment about using Borland Turbo C compiler. Several programs in 
this book include assembly language routines within the programs. Since Turbo C 
differentiates between upper and lowercase characters in function names, you may 
have problems compiling programs as entered from this book. To avoid this, 
select the OPTION command, then the LINKER command in the command line of 
Turbo C before creating a program. The lowest line in the window displays the 
option “Case sensitive link”. Select OFF here to avoid difficulties with upper and 
lowercase letters. 


45 


Chapter 5 


Using Interrupts from 
Assembly Language 


Unlike programmers using any of the higher level languages, the assembly 
language programmer doesn’t have to rely on complicated functions or procedures 
to call an interrupt. The MOV instruction loads the input parameters into the 
registers provided, and the INT instruction calls the interrupt. 


Certain interrupts, or the functions hidden behind these interrupts, are called 
frequently in many programs. An example of this is interrupt 21H function 9, 
which displays text on the screen. You call it by placing function number 9 in the 
AH register and the offset address of the text you want displayed in the DX 
register. This process looks like this in assembly language: 


mov ah,9 jload function number 9 
mov dx,offset Text ;load offset address of text 
int 21h 7call DOS interrupt 21h 


Even if you call the function very frequently, it doesn’t pay to write a subroutine 
for it since the address of the text to be displayed must be passed. All that remains 
is to load the value 9 into the AH register and to call the interrupt. You'll find the 
three program lines described above included for every function call in a program in 
this chapter. 
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5.1 Using Assembler Macro Functions 


An alternative to this method are macros which most assemblers support. 
Macros 


A macro is a “shorthand” way to write a series of assembly language instructions. 
It has a name and may have one or more parameters. During assembly, if the 
macro name is encountered, the series of instructions and parameters replace the 
macro. 


Below is an example of defining and calling a macro using the Microsoft 
Assembler (MASM). See your assembler’s reference manual for information on 
macro handling (and whether your assembler supports macros). Since this macro 
displays text, we’ ve named the macro PRINT: 


print macro string ;Macro header with Name and Parameter 
mov ah,9 ;load function 9 
mov dx,offset string ;load offset address of the text 
int 2ih 7call DOS interrupt 21h 
endm . ;the endm command terminates a macro 


The first line declares the macro name (PRINT). In this case, the macro also has 
one parameter (string). The assembly language instructions follow in successive 
lines until the ENDM instruction terminates the macro. 


Now you can use the macro to display text: 


print Message 


In this example, Message is the name of a variable containing the text to be 
displayed. In the macro declaration, string is a parameter. During assembly, string 
is replaced by Message and creates the following program lines: 


mov ah,9 
mov dx,offset Message 
int 21h 
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5.2 A Sample Macro 


The following program demonstrates the macro just described. 


PRR RIK RR KKK HRI KKK KEKE KKK KI KIRK EK KKK KKK KKK KKK KAKI KKK KKH AK HK IK KKH IAK IKK K 9 


.* MACRO wn 
o* ng de ill SSE sok) SS suck cl Sich i cl ce ca a ee Se a6 Sin wi ect tes sec ed va as ce as ips ig ca tibia fs iis cs sas a a ea a la cae see a a Sg a> 
pe Task : in this Program a Macro is used for output xs 
7* of a String with Function 9 of Interrupt 21H xs 
OK eet cad chi even ea ee Se ee ee ee Se ea ea ee a a eae ee eee Se eee *e 
:+ Author SMI CUAES “ST CCRER ses 
as developed : 08/30/87 i 
;* last Update : 04/08/89 is 
OW Es Ss as ee es Ss ks ed ec ce as Se ceed ee ee ee a eS ee a SS eee a eS ee eee eee eee ke 
Lf LA 
s assembly : MASM MACRO; nS 
i : LINK MACRO; ke 
al ‘uc ssn ces i SOUS cS em ds sow ws mn Sut ei ists min wo Sais ts amos om ems as ees ass oa pn cm sah yay mis Gam a vm tn‘ sy o's ss emis cs aa sui om we 
7* Call: : MACRO 5 
PKK HK KKK KKK KKK KR IAK KKK KK KKK IKK HK KKK KKK KKK KKK HK KKK KK A KKHKKKKKKKKEKK KK 8 


Print macro String ;this is the macro 
mov ah,9 zgload function number 
mov dx,offset String z;load offset address of text 
int 21h 7;call DOS interrupt 
endm 7End of macro 
CR equ 13 ;ASCII-Code of carriage return 
LF equ 10 7;ASCII-Code of linefeed 
TEND equ "S$" ;End of a character string 


Data segment 
Text db CR, LF,"This is how MACROS are used",CR, LF, TEND 


Data ends 


stack segment STACK 
Gw 64 dup (?) 


stack ends 


Program segment 
assume CS:Program, DS: Data, SS:stack 
Start proc far ;program starts here 


mov ax,Data ;set data segment register 
mov ds,ax 


Print Text ;Macro inserted here 
mov ax, 4C00h ;Program terminated with call of a 
int 21h 7DOS function with return of error-code 0 
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Start endp zEnd of procedure 


8 SSS SSS Se a aS Ss Sa = 


Program ends 
end Start ;begin with START 


After you enter the source program, it can be assembled, linked and executed as 
indicated in the header. 


Most of the lines in this listing have nothing to do with the actual program but 
are definitions and declarations for the assembler. 


The macro and constants are defined in the first part of the program, which helps to 
make the listing more understandable to the reader. The definition of the data 
segment follows, where the string to be displayed is stored as a character string. It 
is preceded and followed by a carriage return and a linefeed to display a blank line 
before and after the actual text. The text ends with the character “$” (the DOS 
function used for text display always looks for this as the last character in a 
string). 


Following the data segment is the stack segment, which controls the stack during 
program execution. Since the program is not very large, the stack can be fairly 
small. The last segment is the code segment which contains the program 
instructions. It consists of only five commands: The first two instructions 
initialize the program. They load the segment address of the data segment into the 
DS register to provide access to the text in this segment. Then the macro PRINT 
is called, and the text is passed to it. 


The following instructions terminate the program by calling a DOS function. 


Note: You may find it useful to group together certain macros into a file or 
library. When one of these macros will be used in a program, the 
library may be linked or included with the assembly language code. 


Chapter 6 


The Disk Operating System 


The following chapter discusses the PC’s operating system, which the PC loads 
from floppy diskette or hard disk. It is commonly referred to as PC-DOS, MS- 
DOS or just DOS. 


What is DOS? 


Most users only know the user interface of DOS, with which you run programs, 
format disks, etc. In the following sections, however, you'll view DOS from an 
angle you may not have known existed. 


Beneath the surface of DOS many processes takes place. DOS uses a large number 
of different routines (called functions) to accomplish its tasks. These functions are 
available to the user as well as to DOS. The main focus is on how these functions 
can be used in practical applications. 


This chapter includes a historical sketch of the development of DOS, highlighting 
its origins in the CP/M operating system. You'll learn the differences between 
transient and resident commands, COM and EXE files, and DOS file access. 


The data structures which act as the connecting link between the different DOS 
functions will also be examined in this chapter. These data structures make mass 
storage devices such as floppy disks and a hard disk possible. 


Finally, this chapter discusses each DOS function in detail, and includes a brief 
look at DOS Version 4.0. 
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6.1 A Short History of DOS 


DOS appeared in 1980, at a time when 8-bit systems and CP/M 80 operating 
systems made up the majority of microcomputers. A few years before, Intel had 
designed the 8086 microprocessor, the first generation of 16-bit microprocessors. 


In April 1980 the CP/M-86 operating system announced by Digital Research for 
use on the 8086 processor was unavailable. A programmer named Tim Paterson 
began developing a new operating system. This system is the ancestor of the 
current MS-DOS. 


At this time a lot of software was available for CP/M-80 systems. The 
development of new software for an 8086 operating system would have required 
enormous expenses and effort. Paterson’s goal was to allow easy conversion of 
existing software from CP/M-80 to the new operating system. He tried to include 
the functions and the most important data structures of the CP/M-80 operating 
system, while removing the weak points of CP/M-80. The finished product was an 
operating system that required only 6K of memory. Programs developed for CP/M- 
80 could also be converted with little effort to the 8086. The new system was 
named 86-DOS. 


Meanwhile IBM was developing a 16-bit microcomputer. Microsoft offered to 
develop an operating system for it. Microsoft obtained a prototype of the new 
computer from IBM, bought the rights to Paterson’s operating system, and made 
some enhancements to the software. Even though Paterson was participating in the 
project, the strict security provisions of IBM prevented him from seeing the 
machine for which he had developed an operating system. Despite this, the 
development work was concluded in August of 1981. The new operating system 
was released for the IBM PC under the name MS-DOS. 


Many changes have been made to DOS since 1981. Because these changes are of 
great significance to the DOS programmer, this chapter contains a segment for 
each major version of DOS. Each segment lists changes from preceding versions 
with explanations. Many components of DOS are explained here, which will give 
you some idea of the complexity of an operating system. 


Version 1.0 
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This version represented a compromise for Microsoft. They had relied heavily on 
CP/M-80 and needed to transfer existing programs quickly and easily. This can be 
seen in the fact that the file names (eight-character filename, three-character 
extension) was identical with CP/M-80. Also, the designation of the disk drives 
and the internal structure had many similarities to the successful 8-bit operating 


-system. 
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During this time many improvements and enhancements of the hardware occurred, 
such as more RAM and faster disk drives. Microsoft decided to make DOS more 
hardware independent by removing the association between physical file length and 
logical file length. 


In CP/M-80 every disk was divided into 128-byte units which could only be 
accessed as a whole. This is why you couldn’t access individual bytes on the disk 
(this created a programming problem that shouldn’t have existed in the first place). 
DOS solved this problem by making the logical and physical data length 
independent of one another. In addition, functions were implemented to permit 
reading or writing of more than one data set of a file on a disk. Treating the input 
and output devices like files achieved hardware independence. These input and 
Output devices were assigned their own names: 


CON (Keyboard and Display) 
PRN (Printer) 
AUX (serial Interface) 


If you used one of these three names instead of a filename to access a file with a 
DOS routine, then the computer addressed the corresponding device and not the 
disk drive. This also permitted redirecting input and output from the keyboard or 
screen to a file or other device. 


Before this time, DOS only supported program files which loaded and executed 
from a fixed location in memory. This proved to be impractical, and so Version 
1.0 introduced a new program file type. This new file type had a file extension of 
-EXE instead of .COM. An .EXE file could be stored and executed from almost 
any memory location. 


Two changes were made to the command processor, the part of the operating 
system which accepts commands from the user and controls the execution of these 
commands. The first change was to store the command processor in a separate file 
named COMMAND.COM. This allowed programmers to develop a customized 
command processor and link it to the system. 


The second change was to divide the command processor into a resident and a 
transient portion. This approach was taken because early PC systems contained 
only a small amount of memory. The resident portion was written to be as small 
as possible. Many DOS commands were stored on disk and loaded and run only 
when required, hence the name transient. Examples of transient commands are 
DISKCOPY and FORMAT. 


A major innovation that took MS-DOS Version 1.0 beyond CP/M-80 was the 
introduction of the FAT (file allocation table) on disk. Every entry in this table 
corresponds to a data area of 512 bytes (called a sector) on the disk. The FAT 
indicates whether the sector is allocated to a file or is still available. 


53 


6. The Disk Operating System PC System Programming 


The FAT has special significance in connection with the directory entry which 
exists for every file type. Besides the filename and other information, it also 
indicates the number of an entry in the FAT which corresponds with the first 
sector of a file on the disk. This FAT entry points to another FAT entry which 
indicates the next sector which was allocated to the file. The other FAT entries on 
a disk perform the same task. 


In conclusion two additional developments should be mentioned which make work 
with the PC easier for the user: 


The introduction of batch processing offers the user the option of placing several 
DOS commands into one file. When you “run” this file (which has a file extension 
of .BAT), DOS executes the individual commands from this file as if you had — 
entered the commands from the keyboard, thus saving the user time in entering 
frequently used groups of commands repeatedly. 


The current date and time follows every filename. DOS includes this data to help 


- the user determine the last time a file was modified. 


When IBM introduced a new PC in 1982 which used both sides of a disk for data 
storage, Microsoft released DOS Version 1.1. 


Version 2.0 
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IBM announced a new personal computer in March of 1983, called the PC XT, 
which in addition to the floppy disk drive also had a hard disk (also called a fixed 
disk). The enormous capacity of this hard disk (10 megabytes) allowed the user to 
store several hundred files on one unit, but created some problems for the operating 
system. The largest problem was that DOS could only handle one directory for 
each storage unit. It would be nearly impossible for the hard disk user to maintain 


hundreds of files in a single directory. Microsoft had two options to solve this 


problem: They could either borrow an idea from the CP/M-80 operating system, or 
from the UNIX operating system. 


CP/M views a hard disk as several individual disk drives which share the total 
storage on the hard disk, each with only one directory. 


UNIX uses a hierarchical file system, in which every storage unit has a root 
directory which can contain subdirectories as well as files. Every one of these 
subdirectories can have subdirectories within them. This creates a directory tree 
whose trunk is the root directory and whose branches are represented by the | 
individual subdirectories. 


_ Microsoft chose the hierarchical file system, which has since become a popular 


component of DOS. This was another step away from CP/M-80 toward an 
efficient 16-bit operating system. With the introduction of an hierarchical file 
system some major changes had to be made in the area of file control by DOS. 
Before this time, file access was conducted through a file control block or FCB. 
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This file control block had been introduced for compatibility with CP/M-80. The 
FCB contained important information about the name, size and location of a file 
on disk. This CP/M would not allow access to a file in another directory. 


The DOS developers standardized file access through DOS functions. The access to 
a file occurs exclusively through the file handles. A handle is a numerical value 
passed to the program as soon as it opens a file through a DOS function. The 
FCBs were not eliminated, but the programmer no longer came in contact with 
them since DOS took over the control block manipulation. 


An important innovation was the introduction of installable device drivers. They 
offer the programmer the capability of easily including different devices in DOS, 
such as an exotic hard disk, a mouse or a tape drive. Version 2.0 introduced the 
display device driver ANSI.SYS which gave the programmer flexibility in cursor 
positioning and color selection through DOS functions. 


Version 2.0 added the option of formatting the individual tracks of a disk with nine 
sectors instead of eight. This increased the storage capacity of a single-sided disk 
from 160K to 180K, and the capacity of a double-sided disk from 320K to 360K. 


Version 3.0 


Version 3.0, like Version 2.0, was developed for a new PC, the IBM PC AT. It 
was released in August of 1984 and supported the 20 megabyte hard disk of the 
ATs as well as the high capacity 1.2 megabyte floppy disk drive. Many changes 
occurred in DOS’s internal routines. They contributed to faster execution of certain 
operations, but are transparent to the programmer. 


Version 4.0 


DOS 4.0 appeared on the market in August 1988. Before this, Microsoft released a 
new multiprocessing operating system called OS/2. Before OS/2, multiprocessing 
was unknown to MS-DOS. 


The user can easily see the changes to DOS 4.0 over earlier versions of DOS. In 
place of the line-oriented command line interpreter used by DOS versions 3.3 and 
earlier, DOS 4.0 has a Shell allowing user-defined menus, easy selection of 
applications, files and directories from both mouse and keyboard. 


Most important are the unseen changes made to DOS, particularly in adapting the 
operating system to the new hardware standards on the market. As the operating 
system has grown in power, it has also grown in complexity and memory use. For 
example, earlier versions of DOS were limited to "only" 640K of RAM and a 32 
megabyte hard disk. However, DOS 4.0 handles the Expanded Memory System 
(EMS) following the LIM standard, normal RAM capacity of up to 8 megabytes, 
and hard disks up to 2 gigabytes (2048 megabytes) capacity. 


55 


6. The Disk Operating System PC System Programming 


6.2 Internal Structure of DOS 
Several major components comprise DOS, each with a certain task within the 
system. The three most important components are the DOS-BIOS, the DOS kernel 
and the command processor. Each appear in a separate file. 
DOS-BIOS 
DOS-BIOS is stored in a system file which appears under various names 
(IBMBIO.COM, IBMIO.SYS or IO.SYS). This file has the file attributes Hidden 
and Sys, which means this system file doesn't appear when the DIR command is 
entered. The DOS-BIOS contains the device drivers for the following units: 
CON (Keyboard and Display) 
PRN (Printer) 
AUX (Serial Interface) 
CLOCK (Clock) 
Disk drives and/or hard disks which have the unit 
designations A, B and C 
If DOS wants to communicate with one of these, it accesses a device driver 
contained in this module, which in turn uses the routines of ROM-BIOS. The 
DOS-BIOS (i.e., the connection between individual device drivers and other 
hardware dependent routines) are the most hardware dependent components of the 
operating system, and vary from one computer to another. 
Do not confuse the device drivers in this module with the installable device drivers. 
The DOS-BIOS device drivers cannot be changed by the user. 
DOS kernel 


The DOS kernel in the IBMDOS.COM or MSDOS.SYS file is normally invisible 
to the user. It contains file access routine handles, character input and output, and 
more. The routines operate independent of the hardware and use the device drivers 
of DOS-BIOS for keyboard, screen and disk access. The module can be used by 
different PCs without being limited to one machine. User programs can access 
these functions in the same manner as the ROM-BIOS functions: every function 
can be called with a software interrupt. The processor registers pass the function 
number and the parameters. 


Command processor 


5 6 


Unlike the two modules described above, the command processor is contained in 
the file nnmed COMMAND.COM. It displays the “A>” or “C>” prompt on the 
screen, accepts user input and controls input execution. Many users wrongly think 
that the command processor is actually the operating system. In reality it is only a 
special program which executes under DOS control. 
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6.2 Internal Structure of DOS 


The command processor, also called a shell in programmer's terminology, actually 
consists of three modules: A resident portion, a transient portion and the 
initialization routine. 


The resident portion (the part that always stays in the computer’s memory) 
contains various routines called critical error handlers. These allow the computer to 
react to different events, such as pressing the <Ctrl><C> or <Ctrl><Break> keys 
or errors during communication with external devices (e.g., disk drives and 
printers). The latter cause the message: 


Abort, Retry, Ignore 
or 
Abort, Retry, Fail 


The transient portion contains code for displaying the (A>) prompt, reading user 
input from the keyboard and executing the input. The name of this module is 
derived from the fact that the RAM memory where it is located is unprotected, and 
can be overwritten under certain circumstances. When a program ends, control 
returns to the resident portion of the command processor. It executes a checksum 
program to determine whether the transient portion was overwritten by the applica- 
tion program. If so, the resident portion reloads the transient portion. 


The initialization portion loads during the booting process and initializes DOS. 
This part of the command processor will be examined in detail in the next chapter. 
When its job ends, it is no longer needed and the RAM memory it occupies can be 
overwritten by another program. The commands accepted by the transient portion 
of the command processor can be divided into three groups: internal commands, 
external commands and batch files. 


Internal commands lie in the resident portion of the command processor. COPY, 
RENAME and DIR are internal commands. 


External commands must be loaded into memory from diskette or hard disk as 
needed. FORMAT and CHKDSK are external commands. 


After execution the command processor releases the memory used by these 
programs. This memory can then be used for other purposes. 


files 


A batch file is a text file containing a series of DOS commands. When a batch file 
is Started, a special interpreter in the transient portion of the command processor 
executes the batch file commands. Execution of batch file commands is the same 
as if the user entered them from the keyboard. An important batch file is the 
AUTOEXEC.BAT file which executes immediately after DOS is first loaded. 


Like all commands of a batch file, these commands are checked for internal 
commands, external commands or calls to other batch files. If the first is true, the 
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command executes immediately, since the code is already in memory (in the 
transient part of the command processor). If it is an external command or another 
batch file, the system searches the current directory for the command. If such a file 
doesn’t exist in this directory, all directories specified in the PATH command are 
searched in sequence. During the search, only files with the .COM, .EXE or .BAT 
extensions are examined. 


Since the command processor cannot search for all three extensions at the same 
time, it first searches for files with .COM extensions, then for EXE files and 
finally for .BAT files. If the search is unsuccessful, the screen displays an error 
message and the system waits for new input. 
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Booting DOS 


When a PC is turned on, the program contained in ROM begins executing. This 
ROM program is sometimes called the ROM-BIOS, POST (power-on self test), 
resident diagnostics or bootstrap ROM. It performs several tests on the hardware 
and memory and then starts to load the DOS. 


First the PC checks for a disk in the floppy disk drive. If a disk exists in the 
floppy disk drive, the PC checks the disk for the boot sector. If a disk is not in the 
drive, the PC searches for a hard disk from which to boot DOS. If no hard disk 
exists, the PC displays an error message asking the user to insert a system disk. 


The first sector on a bootable floppy disk or hard disk is called the boot sector. The 
program in the boot sector is read into memory and executes. First it checks for 
the presence of two files: IBMBIO.COM (sometimes called IO.SYS) and 
IBMDOS.COM (sometimes called MSDOS.SYS). A bootable floppy disk or hard 
disk must contain these two files or an error message is displayed. Next these 
program files are loaded into memory. 


The program file IBMBIO.COM consists of two modules. The first contains the 
basic device drivers—keyboard, display and disk. The second contains the 
initialization sequence for DOS. When the IBMBIO.COM program executes it 
continues to initialize the system by moving the DOS kernal (loaded in the 
IBMDOS.COM program file) to the last available memory location. 


The DOS kernal builds several important tables and data areas, and performs 
initialization procedures for individual device drivers which were loaded with the 
IBMBIO.COM program file. 


Next, DOS searches the boot disk for a file named CONFIG.SYS. If found, the 
commands contained in the file are executed. These commands add device drivers to 
DOS, allocate disk buffers and file control blocks for DOS and initialize the 
standard input and output devices. 


Lastly the command processor COMMAND.COM (or other shell specified in the 
CONFIG.SYS file) is loaded and control is passed to it. The booting process ends 
and the initialization routines remain as “garbage” data in memory until 
overwritten by another program. 
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COM and EXE Programs 


DOS recognizes three types of “program” files: those with file extensions of BAT, 
COM and EXE. 


This section describes the structure and functions of these last two program types. 


One difference between COM and EXE program files is in the size limitation for 
each type of program. A COM program cannot exceed 64K in size. An EXE 
program can be as large as the memory capacity available to DOS. 


In a COM program, the program code, data and stack are stored in one 64K 
partition. All of the segment registers are set at the start of the program and remain 
fixed for the duration of the program execution. They point to the start of the 64K 
memory segment. The contents of the ES register may be changed however, since 
it has no direct effect on program execution. 


In an EXE program, the code, data and stack may be stored in different segments, 
and depending on program size, may be distributed over several segments. 


While a COM program file is stored on disk as an image copy of RAM memory, 
an EXE program file is stored in a special format that will be described shortly. 


Both program types can be loaded and started using the DOS EXEC function. Any 
user can access this, but the command processor uses it for executing external 
commands. Before the EXEC function loads the program into memory, it reserves 
the RAM memory to hold the program. At the beginning of this memory the 
EXEC function stores a PSP (program segment prefix) data structure. The program 
is then loaded immediately following the PSP. The segment registers and the stack 
are initialized and the program is given control. Later, when the program ends, the 
memory is released based on the contents of the PSP. 
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Segment address of memory (1 word) 
allocated for a program | 
+ 048 


Interrupt 21H call (5 bytes) 


+ OAH | Copy of interrupt (2 words) 0000:0000 
vector 22H 

+ OFH | Copy of interrupt (2 words) 
vector 23H 


(2 words) 


Number of characters 
in command line 


Structure of the PSP 


The PSP itself is always 256 bytes long and contains information important for 
DOS and the program to be executed. 


Memory location OOH of the PSP contains a DOS function call to terminate a 
program. This function releases program memory and returns control to the 
command processor or the calling program. Memory location 05H of the PSP 
contains a DOS function call to interrupt 21H. Neither of these are used by DOS, 
but are leftovers from the CP/M system. 


Memory location 02H of the PSP contains the segment address to the end of the 
program. Memory location OAH contains the previous contents of the program 
termination interrupt vector. Memory location OEH contains the previous contents 
of the <Ctrl><C> or <Ctrl><Break> interrupt vector. Memory location 12H 
contains the previous contents of the critical error interrupt vector. For each of 
these memory locations, the program changes one of the corresponding vectors 
during execution; DOS can use the original vector in the event that it detects an 
error. 


Location 2CH contains the segment address of the environment block. The 
environment block contains information such as the current search path and the 
directory in which the COMMAND.COM command processor is located on disk. 
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Memory locations 5CH through 6CH contain a file control block. This FCB is 
not often used by DOS since it does not support hierarchical files (paths) and is 
also left over from CP/M. 


The string of parameters that are entered on the command line following the 
program name is called the command tail. The command tail is copied to the 
parameter buffer in the PSP beginning at memory location 81H and its length is 
stored at memory location 80H. Any redirection parameters are eliminated from the 
command tail as it is copied to the parameter buffer. The program can examine the 
parameters in the parameter buffer to direct its execution. 


The parameter buffer is also used by DOS as a disk transfer area (DTA) for 
transmitting data between the disk drive and memory. Most DOS programs do not 
use the DTA contained in the PSP because it is another leftover from CP/M. 


PSP (256 BYTES) 


Code 


SS:0000 
DS:0000 ES:0000 


ES:0000 - | DS:0000 
PSP (256 BYTES) 


CS:0000 
cS:IP-— 
Code, data 
and stack in 
one 64K segment 


(Address defined 
by the END 
command in an 
assembler 
program) 


Stack adjusts 
| [to the direction 
SS: FFFF of data and code! DS:0000 
CS:FFFF | 
eaaed SS:0000 
ES: FFFF 


SS:SP 


A comparison of COM and EXE programs in memory 


6.4.1 COM Programs 


COM program files are stored on disk as an image copy of memory. Because of 
this, no further processing is required during loading. Therefore COM programs 
load faster and start execution faster than EXE programs. 


A COM program loads immediately following the PSP. Execution then begins at 
the first memory location following the PSP at offset 100H. For this reason, a 
COM program must begin with an executable instruction, even it if is only a 
jump instruction to the actual start of the program. 
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COM program memory limits 


As described in the previous section, a COM program is limited to 64K (65,536 
bytes) in length. The PSP (256 bytes) and at least 1 word (2 bytes) for the stack 
must be reserved from this total. Even though the length of the COM program can 
never exceed 64K, DOS reserves the entire available RAM for a program. 
Therefore DOS can allocate no further memory, and the COM program cannot call 
another program using the EXEC function. This limitation can be overcome by 
releasing the unused memory for other uses with a DOS function. 


When control is tured over to the COM program, all segment registers point to 
the beginning of the PSP. Because of this, the beginning of the COM program 
(relative to the beginning of the PSP) is always at address 100H. The stack pointer 
points to the end of the 64K memory segment containing the COM program 
(usually FFFEH). During every subroutine call within the COM program, the 
stack is adjusted by 2 bytes in the direction towards the end of the program. The 
programmer is responsible for preventing the stack from growing and overwriting 
the program, which would cause it to crash. 


There are several ways to end a COM program and return control to DOS or the 
calling program: 


If the program runs under DOS Version 1.0, it can be terminated by calling 
interrupt 21H function 0, or by calling interrupt 20H. It can also be terminated by 
using the RET (RETurn) assembler instruction. When this instruction executes, 
the program continues at the address which is at the top of the stack. Since the 
EXEC function stored the value 0 at this location before turning control over to 
the COM program, program execution continues at location CS:0 (the start of the 
PSP). Recall that this location contains the call for interrupt 20H which 
terminates the program. 


Programs that run on versions later than DOS Version 1.0, are terminated using 
interrupt 21H function 4CH. The terminating program can pass a numeric return 
code to the calling program. For example, a value of 0 may indicate that the 
program executed successfully, while a non-zero value indicates an error during 
execution. 


Next we’ll talk about a few of the details that the assembly language programmer 
will have to take care of in developing a COM program. Note that the high level 
language programmer is usually insulated from these details by the compiler or 
interpreter, So you may want to skip ahead. 


A COM program is limited to a 64K size. The code and data for the program must 
be contained within a single segment and addressed through NEAR procedures. 
Therefore an assembly language program that is to become a COM program may 
not contain any FAR procedures. 
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Before calling a COM program, DOS reserves all available memory for the 
program even though it normally uses only one 64K segment and indicates this by 
setting memory location 2 in the PSP. Usually the program terminates and the 
memory is made available to DOS again. 


In some circumstances you may want to write a program which is to remain 
resident after execution. But DOS thinks that there isn’t any memory available. 
This prevents other programs from loading and executing. 


In other circumstances you may want to execute another program from this COM 
program using the EXEC function. Again, since DOS thinks that memory is 
unavailable, it won’t allow the new program to run. 


Both of these problems can be circumvented by freeing up the unused memory. 


There are two approaches in doing this: release only the memory outside of the 
64K COM segment or release memory outside of the 64K COM segment plus any 
unused memory within the 64K COM segment. This creates more memory for 
other programs, but relocates the stack outside the protected COM segment 
memory, leaving it open to be overwritten by other programs. Because of this, the 
stack must be relocated to the end of the code segment before releasing the 
memory. The stack must have a certain limit in size (in most cases 512 bytes will 
be more than enough). 


The following sample program can serve as an example for developing a COM 
program. A small (init) routine relocates the stack to the end of the code segment 
after the start of the program and releases all remaining memory. Even when this 
program loads another program, it remains resident. This routine can be useful to 
applications, and can be part of any COM program. 


;testcom.asm 
code segment para ‘CODE' ;Definition of CODE-segments 


org 100h 7;Starts at Address 100H 
;directly behind the PSP 


assume cS:code, ds:code, es:code, ss:code 


yall segments point to the CODE 
7 segment 


start: jmp init ;Call of the Initialization Routine 


;-- Data, Buffers and ---------- 
y~- Variables can be stored here 


prog proc near ;this Procedure is the actual 


;Main program and is executed after 
jthe Initialization 


mov ax,4C00h ;Terminate Program through calling a 
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int 21h ;DOS function on error code 0 
prog endp 7End of the PROG procedure 


go-~ Initialization ----9~-<-----9 99929 err 


init: mov ah, 4Ah 7Change Function number for memory size 
mov bx,offset endp 7Calculate number of paragraphs (16 byte 
mov cl,4 zeach) available to the program 
shr bx,cl 
inc bx 
int 21h 7Call function through DOS-Interrupt 
mov sn offset andn pSet mew stack=Pointer 
jmp prog 


init_end label near 


dw (256-((init_end-init) shr 1)) dup (?) 


jthe stack has 256 Words, but includes 
;the code of the INIT-Routine which 
;after its execution is no longer needed 


endp equ this byte 7;End of memory used by this 
7 program 
v =o End SSS eS Te Se LE SES Te SS es eS Se eS Se LS ee Te ee eS Se ee ES Ee ee ee LS LS EE LE EE SS LE LE TE Ll SS SS SS SS SE ES Se SS SS 
code ends sEnd of the CODE-segment 
end start 7;End of the Assembler-Program. For 


z;execution use START command 


First you must assemble the source program using the assembler. In the following 
example, we are using the Microsoft assembler. Following assembly, you then 
link the object code using the LINK program. When you execute the LINK 
program, the following message appears: 


Warning: no stack segment 


You can disregard this message. If the program contains no errors, the LINK 
program creates an EXE file. Since you want a COM program and not an EXE 
program developed, you must run the EXE2BIN program as the last step. This 
converts EXE programs into COM programs. Here are the steps for preparing an 
assembly language program using the Microsoft assembler. The program to 
assemble is named TESTCOM.ASM. 


masm testcom; 
link testcom; 
exe2bin testcom.exe testcom.com 


If all steps were carried out correctly, the program TESTCOM.COM can be 
executed from DOS by simply typing TESTCOM. 
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6.4.2 EXE Programs 


EXE programs have an advantage over COM programs because they are not 
limited to a maximum length of 64K for code, data and stack. The disadvantage of 
this is the greater complexity of these files. This means that in addition to the 
program itself, other information must be stored in an EXE file. 


EXE vs. COM 
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EXE programs contain separate segments for code, data and stack which can be 
organized in any sequence. Unlike a COM program, an EXE program loads into 
memory from disk and undergoes processing by the EXEC function and then 
finally begins execution. This is necessary because of the limitations already 
described for COM programs. 


EXE programs aren’t limited to loading at a fixed memory location, but to any 
desired location in memory that’s a multiple of 16. Since an EXE program can 
have several segments, this requires the use of FAR machine language 
instructions. For example, a main program can be in one segment and call a 
subroutine in another segment. The segment address must be provided for this 
FAR instruction in addition to the offset for the routine to be called. The problem 
is that the segment address may be different for every execution of the program. 


COM files avoid this problem since the program size is limited to 64K, which 
makes the use of FAR commands unnecessary. EXE programs solve this problem 
in a more complex way: the LINK program places a data structure at the beginning 
of every EXE file which contains the addresses of all segments, among other 
things. It contains the addresses of all memory locations in which the segment 
address of a certain segment is stored during program execution. 


If the EXEC function loads the EXE program, it knows the addresses where the 
various segments should be loaded. It can therefore enter these values into the 
memory locations at the beginning of the EXE file. Because of this, more time 
elapses between the initial program call and when the program actually begins 
execution than for a COM program. The EXE program also occupies more 
memory than a COM program. The following illustration shows the structure of 
the header for an EXE file. 


Abacus 


6.4 COM and EXE Programs 


EXE file header structure 

Contents 

[+00H EXE program identifier (5A4Dh) 
+02H file length MOD 512 


eO2H 
file length DIV 512 


k fr 
= 
© {oO 
sF 


= = 
=1= 
O FO 
i 


+06H Number of segment addresses for passing 
Head’ size in paragraphs 1 WORD 
/+OAH {Minimum no. of extra paragraphs needed [1 WORD 
/+0EFH [Maximum no. of extra paragraphs needed |1 WORD 


SP register contents on program start 
Checksum based on EXE file header 


IP register contents on program start 
f+16H  |Start of code segment in EXE file 


/+18H _|Relocation table address in EXE file 

l+1AH |Overla number 

Buffer memory 

a of passing segment addresses 
(relocation table) 


+2?2H  |Program code, data and stack segment 


tk 
= 
© 
E 


f- 
= 
oO 
6 


ey) 
ae PP 
SISiS 
aE 


S166 


-- 
= 
© 


EXE file header construction 


After the segment references within the EXE program have been resolved to the 
current addresses, the EXEC function sets the DS and the ES segment register to 
the beginning of the PSP which also precedes all EXE programs in memory. 
Because of this, the EXE program can access the information contained in the 
PSP, such as the address of the environment block and the parameters contained in 
the command line (command tail). The stack address and the contents of the stack 
pointer are stored in the EXE file header and accessed from there. This also applies 
to the code segment address containing the first instructions of the program, and 
the program counter. After the values have been assigned, the program execution 
Starts. 


To ensure compatibility with future DOS versions, an EXE program should 
terminate by calling interrupt 21H function 4CH. 


Of course, memory must be available for the EXE program. The EXE loader 
determines the total program size based on the size of the individual segments of 
the EXE program. Then it can allocate this amount of memory and some 
additional memory immediately following the EXE program. The first two fields 
of the EXE program file header contain the minimum and maximum size of 
memory required in paragraphs (1-6 bytes). 


First, the EXE loader tries to reserve the maximum number of paragraphs. If this 
is not possible the loader tries to reserve the remaining memory which may be no 
smaller than the minimum number of paragraphs. These fields are determined by 
the compiler or assembler, not the linker. The minimum is 0 and the maximum 
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allowed is FFFFH. This last number is unrealistic in most cases (it adds up to 1 
megabyte) but reserves the entire memory for the EXE program. 


This brings us back to the same problem as in COM programs. EXE files make 
poor resident programs, but an EXE program may need to call another program 
during execution. This is possible only by first releasing the additional reserved 
memory. The following program below contains a routine which reduces the 
reserved memory to a minimum. 


The program uses separate code, data and stack segments. It can serve as a model 
for other EXE programs that you can write. 


== Stack ==s===s====sssssssssssesssssssssssssssSsSSsesSeSSsSseeseassssas= 
stack segment para stack ;Definition of the stack-segment 
dw 256 dup (?) sthe stack has 256 Words 
stack ends ;End of the stack-segment 
p== Data =s=ssssssssssssese Sees ee sss SSeS SSS SSS SSS SSS SSS SSS aes Se SSeS sss 
data segment para 'DATA' 7Definition of the Data-segment 


j;all data, buffers and variables can be stored here 


data ends 7End of the Data segment 
code segment para 'CODE' ;Definition of the CODE-segment 


assume cs:code, ds:data, ss:stack 


7CS defines the Code, DS 
;the Data and SS the stack 
7 segment 


prog proc far ;this procedure is the actual 
;Main program and is executed after 
;the program start 


mov ax,data ;Load segment address of the Data segment into 
mov ds,ax ;the DS-Register 
call setfree ;release memory not needed 


;store application program here 3~--------------------- 


mov ax,4C0O0h ;terminate with call of DOS function 
LHe 21h 7on return of error code 0 
;terminate 
prog endp 7End of PROG Procedure 


~~ SETFREE : release memory storage not occupied --~-------------- 

Inputt : ES = Address of PSP 

—-- Output > none 

~~ Register : AX, BX, CL and FLAGS are changed 

Info : Since the stack-segment is always the last segment in an 
EXE file, ES:0000 points to the beginning and SS:SP 
to the end of the program in storage. Because of this the 
length of the program can be calculated. 


“=a Se Se Ne Be Bp Re Vs 
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setfree proc near 


mov bx,ss ;subtract the two segment addresses 

mov ax,es ;from each other. The result is the 

sub bx,ax snumber of paragraphs from PSP to 
sthe beginning of the stack 

mov ax,Ssp ;since the stackpointer is a the end 

mov cl,4 ;of the stack segment, its content 

shr ax,cl z;gives the length of the stacks 

add bx,ax zadd to the present length 

inc bx ;one more paragraph as a precaution 

mov ah, 4an 7pass new size to DOS 

int 2ih 

ret zback to calling program 


setfree endp 


code ends 7;End of the CODE-segment 
end prog 7;End of the Assembler program. 
;Start execution with the PROG procedure 


To develop an EXE program, it must be assembled like a normal program with an 
assembler. Then it is linked with the LINK program. If the program contains no 
errors, the LINK program creates an EXE file. 


Here are the individual steps for preparing an EXE program from the assembly 
language source named TESTEXE.ASM. 


mMasm testexe; 
link testexe; 


If all these steps were executed correctly, the program TESTEXE.EXE can be 
started from the DOS level by typing TESTEXE. 
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Character Input and Output from DOS 


When first learning a programming language, many beginners learn the basic input 
and output instructions of the language. In much the same way, programmers get 
their experience writing DOS accessible programming by using the functions for 
character input and output. For this reason, this book starts with these input and 
output functions instead of more complex functions. These input and output 
functions can address the keyboard, screen, printer and serial interface. 


The functions can be divided into two types: those carried over from the CP/M 
operating system and those borrowed from the UNIX operating system. While the 
two types of functions can be intermixed, we recommend that you use one type of 
function throughout a program for the sake of consistency. 


The UNIX type functions use a handle as an identifier to a device. Because of 
recent DOS trends to move closer to UNIX, you may want to give the handle 
functions precedence. 


Handle Functions 


The handle functions perform file access as well as character input to or output 
from a device. DOS recognizes the difference by examining the name assigned by 
the handle. If the handle is a device name, it addresses the device; otherwise it 
assumes that file access should occur. The device names are as follows: 


CON Keyboard and display 

AUX Serial Interface 

PRN Printer 

NUL Imaginary device (nothing happens on access) 


Output and input go to and from the AUX, PRN and NUL devices. For the device 
CON, output is sent to the screen and input is read from the keyboard. 


When DOS passes control to a program, five handles are available for access to 
individual devices. These handles have values from 0 to 4 and represent the 
following devices: 


Standard input (CON) . 


[1 | Standard output (CON) j . 
2 | Standard output for error messages (CON) 


Standard serial interface (AUX) | 


| Standard printer (PRN) 


Here is a short example to help demonstrate the use of this table: 
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Display error message 


If a program wants to accept input from the user, the handle function 0 indicates 
this during the call since the standard input device is addressed. Handle 0 normally 
represents the keyboard, permitting user input from the user to the program. Since 
the user can redirect standard input, you can redirect input to originate from a file 
instead of the keyboard. This redirection remains hidden from the program. 


Before discussing these devices, here are some functions used to access any device. 


Function 40H of interrupt 21H sends data to a device. The function number (40H) 
is passed in the AH register and the handle is passed in the BX register. For 
example, to display an error message, the value 2 indicates the handle for 
displaying the error message (this device cannot be redirected, so handle 2 always 
addresses the console). The number of characters to be in the error message is 
passed in the CX register. The characters making up the message are stored 
sequentially in memory whose segment address is stored in the DS register and 
offset address in the DX register. 


Following the call to the function, the carry flag signals any error. If there was no 
error, the carry flag is reset and the AX register contains the number of characters 
that were displayed. If the AX register contains the value 0, then there was no 
more space available on the storage medium for the message. If the carry flag is 
set, the error message was not sent and an error code is indicated in the AX 
register. An error code of 5 indicates that the device was not available. An error 
code of 6 indicates that the handle was not opened. 


Function 3FH of interrupt 21H reads character data from a device and has many 
similarities to the previous function. Both functions have identical register usage. 
The function number is passed in the AX register and the handle in the BX 
register. The number of characters read is passed in the CX register and the 
memory address of the characters transferred are passed in the DS:DX register pair. 


Following the call to the function, the carry flag also signals any error. Again, any 
error code is passed in the AX register. Error codes 5 and 6 have the same meaning 
as when using function 40H. If the carry flag is reset, then the function executed 
successfully. The AX register then contains the number of characters read into the 
buffer. A value of 0 in the AX register means that the data to be read should have 
come from a file, but that this file contains no more data. 


As we already mentioned, it’s possible to redirect the input or output when 
accessing DOS. For example, a program that normally expects input from the 
keyboard can be made to accept the input from a file. So, to avoid having input or 
Output redirected, you can open a new handle to a specific device which insures that 
the transfer of data to or from the desired device takes place instead of to or from a 
redirected device. 


Use function 3DH of interrupt 21H to open such a device. 
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The function number 3DH is passed in the AH register. The AL register contains 0 
to enable reading from the device, 1 to enable writing to the device and 2 for both 
reading and writing to the device. The name of the device is placed in memory 
whose address is passed in the DS:DX register pair. So that the DOS can properly 
identify the device name, the names must be specified in uppercase characters. The 
last character of the string must be an end character (ASCII value 0). 


Following the function calls the status is indicated by the carry flag. A reset flag 
means that the device was opened successfully and the handle number is passed 
back in the AX register. A set flag indicates an error and the AX register contains 
any error code. 


The handle is closed using function 3EH of interrupt 21H. The function number is 
passed in the AH register and the handle number is passed in the BX register. The 
carry flag again indicates the status of the function call. A set carry flag indicates 
an error. 


You can also close the predefined handles 0 through 4 using this function. But if 
you Close handle 0 (the standard input device) you’ll no longer be able to accept 
input from the keyboard. 


Let’s examine the special characteristics of each device. 


Keyboard 
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The keyboard can perform only read operations. The results of the read operations 
depend on the mode in which the device was addressed. Here DOS differentiates 
between raw and cooked. In the cooked mode DOS checks every character sent to a 
device or received from a device to see if it is a special control character. If DOS 
finds a special control character, it performs a certain action in response to the 
character. In raw mode the individual characters are passed through unchecked and 
unmanipulated. DOS normally operates the device in cooked mode for character 
input and output. However, you can switch to raw mode within a program (see 
below). 


The difference between cooked and raw mode can be best explained by an example 
of reading the keyboard. Assume that 30 characters are read from the keyboard in 
cooked mode. As you enter the characters DOS allows you to edit the input using 
several of the control keys. For example <Ctrl><C> and <Ctrl><Break> abort the 
input. <Ctrl><S> temporarily halts the program until another key is pressed. 
<Ctrl><P> directs subsequent data from the screen to the printer (until <Ctrl><P> 
is pressed again). <Backspace> removes the last character from the DOS buffer. If 
the <Enter> key is pressed, the first 30 characters (or all characters input up to 
now if there are less than 30) are copied from the DOS buffer into the input buffer 
of the program without the control characters. 


In raw mode all characters entered (including control characters) are passed to the 
calling program without requiring the user to press the <Enter> key. After exactly 
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Screen 


Printer 


Serial 
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30 characters, control passes to the calling program, even if you pressed the 
<Enter> key as the second character of the input. 


To display characters on the screen, handle 1 is usually addressed as the standard 
output device. Since this device can be redirected, output through this handle can 
pass to devices other than the screen. On the other hand, you cannot redirect the 
standard error outpul device (handle 2), so error messages that pass through this 
handle always appears on the screen. This handle is recommended for character 
display on the screen only. 


The screen is normally addressed in cooked mode—every character displayed on the 
screen is tested for the <Ctrl><C> or the <Ctrl><Break> control characters. This 
test slows down the screen output, so sometimes changing to raw mode decreases 
program execution time. 


Unlike the keyboard and screen, printer output cannot be redirected—at least not 
from the user level. An exception to this rule is redirecting output from a parallel 
printer to a serial printer. Characters ready to print can be sent to a buffer before 
they are sent to the printer. Handle 4 is used to address the standard printer. There 
are three standard printer devices LPT1, LPT2 and LPT3. Device PRN is 
synonymous with LPT1. When this handle is opened the device name is specified 
as one of the three: LPT1, LPT2 or LPT3. 


interface 


Much of the information that applies to the printer also applies to the serial 
interface. For example, serial input and output cannot be redirected to another 
device (e.g., from a serial printer to a parallel printer). The programmer can use the 
predefined handle 3 for serial access, through which you can address the standard 
serial interface (AUX). 


Handle 3 is used to address the standard serial device. The two are names COM1 
and COM2. A PC can have multiple serial interfaces. Only the first two (COM1 
and COM2) are supported by DOS. Since the system doesn’t know exactly which 
interface to access during AUX device access, you should open a new handle for 
access to the specific device. 


Errors during read operations in DOS mode are returned to the serial interface in 
cooked mode. The number returned to the AX register will not match the number 
of characters actually read. We recommend that you operate the serial interface in 
the raw mode, even if this mode ignores control characters such as <Ctrl><C> and 
EOF (end-of-file). 
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6.5.2 Traditional DOS Functions 


The DOS functions for input and output aren’t based on the handle oriented 
functions. If you use these functions you won’t need to specify a handle, since 
each function pertains to a specific device. 


Below are the various input and output devices and the way in which these 
functions work with them. 


Keyboard 
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There are seven DOS functions for addressing the keyboard but they differ in many 
ways. For example, they respond differently to the <Ctrl> <Break> key. Some 
functions echo the characters on the screen; others don’t. 


You can use DOS functions 01H, 06H, 07H and 08H to read a single keyboard 
character. The function number is passed in the AH register. Following the call, 
the character is returned in the AL register. 


For DOS function 01H, DOS waits for a keypress if the keyboard buffer is empty. 
When this happens, the character is echoed on the screen. If the keyboard buffer is 
not empty, a new character is fetched and returned to the calling program. DOS 
function 06H can be used for both character input and output. To input a character 
a value of FFH is loaded into the DL register. This function doesn’t wait for a 
character to be input but returns immediately to the calling program. If the zero 
flag is set, a character was not read. If the zero flag is reset, a character was read and 
returned in the AL register. The character is not echoed on the screen. 


DOS functions 07H and 08H are used to read the keyboard similar to function 1. 
Both either fetch a character from the keyboard buffer or wait for a character to be 
entered at the keyboard. Neither echo the character to the screen. They differ in that 
function 08H responds to <Ctrl><C> and function 07H does not. 


By using function OBH, a program can determine whether one or more characters 
are in the keyboard buffer before calling any functions that read characters. After — 
calling this function, the AL register contains 0 if the keyboard buffer is empty, 
and FFH if the keyboard buffer is not empty. 


DOS function OCH is used to clear the keyboard buffer. After it is cleared, the 
function whose number was passed to function OCH in the AL registered is 
automatically called. 


t 
DOS function OAH is used to read a string of characters. Again this function 
number is passed in the AH register. In addition, the memory address of a buffer 
for the character string is passed in the DS:DX register pair. This buffer is used to 
hold the character string. The first byte of the buffer indicates the maximum 
number of characters that may be contained in the buffer. 
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When this function is called, DOS reads up to the maximum number of characters 
and stores them in the buffer starting at the third byte. It reads until either the 
maximum number of characters is entered or the <Enter> key is pressed. The 
actual number of characters is stored in the second byte of the buffer. Extended key 
codes which occupy two bytes each in the buffer may be entered. The first byte of 
the pair (ASCII value 0) signifies that an extended key code follows. This means, 
for example, that for a maximum buffer size of 10 bytes, only five extended 
characters may be entered. 


The following table illustrates how the various functions respond to <Ctrl><C> 
or <Ctrl><Break>, and provides a quick overview of the individual functions for 
character input. 


ct. <ctr1><c> 

O1H_ | Character input yes tes 

JO6H_ | direct character input rf 

[o7H_ | Character input 

[08H yes 2 | 
byes 

OBH fyes 

OCH 


[Ol 


08H Character input im 
Character string input inmosd 
[OBH | Read input-status 


[OCH Reset input-buffer then input varies varies 


Screen output 


There are three DOS functions for character output. 


DOS function 02H outputs a single character to the screen or standard output 
device. The character is passed to the DL register. 3 


DOS function 06H which is multi-purpose is also used to output a single 
character. The character is passed in the DL register. You can see that the character 
whose value is 255 cannot be output since this indicates that the function is to 
perform an input operation. Output using this function is faster than using 
function 02H since it doesn’t test for the <Ctrl><C> or <Ctrl><Break> keys. 


DOS function 09H is used for string output. Again, the function number is passed 
in the AH register. The address of the string is passed in the DS:DX register pair. 
The last character of the string is a dollar sign. In addition, the following control 
codes are recognized. 


"Bell", rings the bell on the PC 
a "Backspace", erases the preceding character and moves the cursor 
back by one character 


"Line Feed", (LF) moves the cursor one line down 


"Carriage Return", (CR) moves the cursor to the beginning of the 


current line 


As with function 02H, this function also checks for <Ctrl><C> or 
<Ctrl><Break>. 
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Printer 


DOS function 05H is used to output a single character to the printer. If the printer 
is busy, this function waits until it is ready before returning control to the calling 
program. During this time, it will respond to the <Ctrl><C> and <Ctrl><Break> 
keys. 


The function number is passed in the AH register. The character to output is 
passed in the DL register. The status of the printer is not returned. Most 
programmers will elect to use the BIOS function instead of the DOS function for 
printer output since you can specify the exact printer device and determine the 
printer status using the BIOS version. See Section 7.12 for more detailed 
information. 


Serial interface 


There are two DOS functions for communicating using serial interface—one for 
input and one for output. Both functions respond to <Ctrl><C> and 
<Ctrl><Break>, but they don’t return the status of the serial interface, nor do they 
recognize transmission errors. 


DOS function 03H is used to input data from the serial interface. The character is 


returned in the AL register. Since the data is not buffered, the data can overrun the 


interface if the interface receives data faster than this function can handle it. 


DOS function 04H is used to output data over the serial interface. The character to 
Output is passed in the DL register. If the serial interface is not ready to accept the 
data, this function waits until it is free. 


Again, most programmers prefer to use the BIOS equivalent functions (see Section 
7.9) to perform serial data transmission because of their more complete data 
handling capabilities. 


Demonstration programs 
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Earlier we mentioned that it was possible to switch a device from cooked mode to 
raw mode and back. The BASIC, Pascal and C programs that follow show you 
how to do this. They use the IOCTL functions which permit access to the DOS 
device drivers (see Section 6.11.7 for details on this routine). These are routines 
which serve as interfaces between the DOS input/output functions and the 
hardware. The IOCTL functions in these programs tell the CON device driver 
(responsible for the keyboard and the display) whether it should operate in the 
cooked mode or in the raw mode. 


To demonstrate how differently characters respond in the two modes, the programs 
switch the CON driver into raw mode first. Then this driver displays a sample 
string several times. Unlike cooked mode, pressing <Ctrl><C> or <Ctrl><S> in 
raw mode has no effect on stopping program execution or text display. 
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BASIC 


After the program finishes displaying the sample string, the driver switches to the 
cooked mode. The sample string is displayed again several times. When you press 
<Ctrl><C> the program stops (Turbo Pascal version). For the BASIC and C 
versions, you can press <Ctrl><C> to stop the program, or press <Ctrl><S> to 
pause or continue the display. 


Switching between the raw and the cooked mode does not take place directly 
through a function. First the device attribute of the driver is determined. This 
attribute contains certain information which identifies the driver and describes its 
method of operation. One bit in this word indicates if the driver operates in raw or 
cooked mode. The programs set or reset this bit, depending on the mode you want 
running the driver. 


listing: RAWCOOK.BAS 


100 
110 
120 
130 
140 
150 
160 
170 
180 
190 
200 
210 
220 
230 
240 
250 
260 
270 
280 
290 
300 
310 
320 
330 
335 
340 
345 
350 
360 
365 
370 
380 
390 
400 
410 
420 
425 
430 
440 


UHR KKK KKK KKK KKK IKK KEKE KKK KK KKK KKK KEKKKEK KKK EKKKKKEKKKKEKKK I 
U% RAWCOOK ae 
ee a a es ee SS ee ee ee ec ee te ks etl Gh be eaten as Gade ee aries cs. we 
‘x Task : make two subroutines available x 
1 to switch the character driver into RAW- or xt 
ox COOKED mode bate 
'* Author : MICHAEL TISCHER aS 
'* developed : 07/23/87 «es 
‘* last Update : 04/08/89 laity 


CHK RIKKI KKK KK KIKI KE KEKE KKK KAKA KKKEKKEKKEKKKKKKKKKKKKKKKE 


CLS : KEY OFF 
PRINT"WARNING: This program can only be started if the GWBASIC was“ 
PRINT"started from DOS with the command <GWBASIC /m:60000>." 


PRINT : PRINT"If this is not the case, please input <s> for Stop." 
PRINT"Otherwise press any key..."; 

AS = INKEYS : IF A$ = “s" THEN END 

IF AS = "" THEN 260 

GOSUB 60000 ‘Install function for interrupt call 
CLS ‘erase display 
HANDLES = 0 ‘handle is connected with console driver 
PRINT“RAWCOOK (c) 1987 by Michael Tischer“ : PRINT 


PRINT"The Console driver (Keyboard and Display) is now in RAW-" 
PRINT"Mode so that during input and output no control characters " 
PRINT"are recognized." 

PRINT"Because of this not even <CTRL> + <S> can stop the " 
PRINT"following output." 


PRINT"Try it ..." : PRINT 

PRINT “Press any key to start output ..." 

GOSUB 25000 ‘Clear keyboard buffer 
AS = INKEYS : IF AS = "" THEN 370 ‘wait for a key 
GOSUB 52000 ‘Switch console driver into RAW mode 
GOSUB 50000 ‘Output Test-String 
CLS 

PRINT"The Console driver (Keyboard and Display) is now in “™ 


PRINT"COOKED mode. Control characters will be recognized during " 
PRINT" input/output." 

PRINT"The following output can be stopped with <CTRL> + <S>." 
PRINT"Try it ..." : PRINT 
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450 PRINT “Press any key to start the output..." 
455 GOSUB 25000 ‘Clear the keyboard buffer 
460 AS = INKEYS : IF AS = "" THEN 460 ‘wait for a key 
470 GOSUB 51000 ‘change console driver to the COOKED mode 
480 GOSUB 50000 ‘output Test-String 
490 CLS 
500 END 
510 ! 
25000 A$ = INKEYS : IF AS = "" THEN RETURN ‘Clear the keyboard buffer 
25010 goto 25000 
50000 PHAR HKK KKK AKER EK KKK KEK KEK KKK KEKE KEKE KEK KKEKKKKEKEKKKEKKKKEK 
50010 ‘* outputs a Test-String on the Standard output device mt 
SOOZD 8 Bm re a a rrr na xs 
50030 ** Input : none aie 
50040 ** Output: none = 
50050 CHAK HKKKKKKEKAAKERKEKEKKEKAKKKEKKEKKAAKEEKAEKKKKKKKKKAKKKKKKKKKKAKS 
50060 ! 
50070 T$ = "Test.... " ‘Output Test-String 
50080 FOR I = 1 TO 250 ‘250 times 
50090 FCT% = &H40 : FCT1% = 0 ‘Write function number for handle 
50100 INR% = &H21 ‘Call DOS-Interrupt 21H 
50110 ADRLO& = 9 : ADRHI% = 0 ‘output 9 characters at a time 
50120 OFSLO% = PEEK(VARPTR(TS)+1) ‘LO-byte of offset address of string . 
50130 OFSHI% = PEEK (VARPTR(TS) +2) ‘HI-byte of offset address string 
50140 HANDLO&S = 1: HANDHI% = 0 ‘address the standard output device 
50150 CALL IA(INR$%, FCT%, FCT1%, HANDHI%, HANDLO%, ADRHI%, ADRLO%, OFSHI%, 

OFSLO$%, 2%, 2%, 2%, 2%) 

50160 NEXT ‘next run 
50170 PRINT 
50180 RETURN ‘back to caller 
50190 '! 
51000 CHAK KKKK IKKE KEAKEKKEKKKEEKKKAREKEKK KKK KEKKAKKKKKKEEEKEEKKEKKKEES 
51010 '* change device driver to COOKED mode alte 
51020 '*~---------~----~----~~-~---- ~~ — - + - -- - -- - -- - + - - - *% 
51030 '* Input : HANDLES = handle connected with the driver ialed 
51040 '* Output: none a 
51050 UR KKKKRKKKRKKKKKERKEKKEKKIKKHK KKK KKKKEIKKAKIAKKIAKIEKKKKKHKAKAKKAKKHAKKKKKEE 
51060 ' 
51070 GOSUB 53000 'Get device attribute of driver 
51080 ATTRIB% = ATTRIB% AND 223 'Find COOKED-Bit 
510390 GOSUB 54000 ‘Set device attribute of driver 
51100 RETURN ‘pack to caller 
51110 ' 
52000 OKRA KKK KKK I KK KKK EK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE KKEKKKKKEEKS 
52010 '* change device driver to RAW mode x 
52020 '*--~-~-------+-~----—-~-----—~--- -- - - - - + + + xe 
52030 '* Input : HANDLES = handle connected to the driver = 
52040 '* Output: none ms 
52050 CREEK KKKKEKRK KKK KEKE KEKE KKK KKK KKK KEKE KEK EK KKK KEKKKKKKKEKKEKKKKEKEK!S 
52060 '! 
52070 GOSUB 53000 ‘Get device attribute of driver 
52080 ATTRIB% = ATTRIB% OR 32 ‘Set RAW-Bit 
52090 GOSUB 54000 ‘Set device attribute of driver 
52100 RETURN ‘back to caller 
52110 ! 
53000 LHRH KK KK KKK KKK KKK KKK KEKE KEE KEE KEK KEKE KEKE KKKKKEKEKKKKKEEKKKKEKKK 
53010 '* Get device attribute of a driver at 
53020 '*--~--~--~--~~—------+~—-—~-+-- - +--+ - = xe 
93030 '* Input : HANDLE% = handle connected with a driver sa 
53040 ‘* Output: ATTRIB% = Attribute of driver ms 
93050 '* Info : 2% used as Dummy-Variable fd 
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53060 '* only Bits 0 to 7 of the device attribute wt 
53070 '* determined a 
53080 CW HK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KEK KEK KEKKKKKKEKKKEKKKS 
53090 ! 

53100 FCT%=&H44 ‘Function number for IOCTL 
53110 FCT1%=0 ‘Read Function number for IOCTL: Read device attribute 
53120 INR%=&H21 ‘Call DOS-Interrupt 21H 
53130 HANDHI% = INT (HANDLE%/256) 'HI-byte of the handle 
53140 HANDLO& = HANDLE% AND 255 'LO-byte of the handle 
53150 CALL IA(INR&%, FCT%, FCT1%, HANDHI%, HANDLO%, 2%, 2%, 2%, ATTRIBS%, 2%, 2%, 2%, 2%) 
53160 RETURN ‘back to caller 
53170 ° 

540090 © te De De Me te te He We Me He He He HH HK KH KKK KKK KKK KKH KKK KEKE KKK KKKKKKEKKK 
54010 '* Set device attribute of a driver a 
54020 8 Rm a a a a a a re is 
54030 '* Input : HANDLE% = handle connected to a driver 7 
54040 ** ATTRIB% = the attribute of the driver eS 
54050 ‘** Output: none =e 
94060 '* Info : 2% used as Dummy-Variable ay 
54070 CHAK KKK KKK HK KKK IK IKK KKK IKKE KKK IK KKK KKK KKK KKKKAKKKKKKKKKK KKK 
54080 ! 

54090 FCT%=&H44 ‘Function number for IOCTL 
54100 FCT1%=1 ‘Set function number for IOCTL: device attribute 
54110 INR%=&H21 ‘Call DOS-Interrupt 21 (h) 
54120 HANDHI% = INT (HANDLE%/256) ‘HI-byte of the handle 
94130 HANDLO& = HANDLE% AND 255 ‘LO-byte of the handle 
54140 ATHI% = INT (ATTRIB%/256) ‘HI-byte of the Attribute 
54150 ATLO& = ATTRIB% AND 255 'LO-byte of the Attribute 
54160 CALL IA(INR$%, FCT%, FCT1%, HANDHI%, HANDLOS, 2%, 2%, ATHI%, ATLO%, 2%, 2%, 2%, 2%) 
54170 RETURN ‘back to caller 
54180 * 

60000 CK KKK KHK KKK KKK KKK KK KKK KKK KK KEK KKK KEKE KKK KKK KKK KKK KKK KEKE KKEKEKEKEKS 
60010 '* Initialize the Routine for Interrupt Call "s 
60020 '*-------—~-~-~~----—~-—~--~--~—---------- ----- ---- -- - -- + -- - -- - -- - -- === ns 
60030 '* Input : none a 


60040 ** Output: IA is the Start address of the Interrupt-Routine aA 


60050 CHKKKHKKKAKKEKKKEKKKEKKKKEKEKKKKKKKAKKKKAKKKKKKKKKKKKKAKKKKKKKKaKKAKKKKK 


60060 ! 
60070 IA=60000! ‘Start address of the routine in the BASIC-Segment 
60080 DEF SEG ‘Set BASTIC-Segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I1%,X% : NEXT ‘Poke Routine 
60110 RETURN ‘back to caller 
60120 !° 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 
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Pascal listing; ,RAWCOOK.PAS 


{ HARRAH RRR KK KKK RAK KARR RK KKK KKK ERK KKK KKK AK KKEKKEKKEKKEKKKEKKEK KK } 


{* RAWCOOK = 
{* sec es ee ut le cs es se ead eae cs Saami ers ae coco 'eo es ns aos ean es ‘ccs ews wes ‘nce ca ose ed Ss Sew ec cw one a ev a on ae eae an enema caw en owen nan ae *} 
{* Task : provide two functions to switch *} 
{* a character device driver to the RAW- *} 
{* or the COOKED mode * } 
{ *¥--------------- -- - +--+ -- - +--+ + as essai Sas cis *} 
{* Author : MICHAEL TISCHER *} 
{3 developed : 08/16/87 i 
{* last Update : 05/11/89 *} 


{RRR IR RIK KEK RIKER HK RIK HK KKK RK KKK IKKE KEKE KK KKK EKER KEKE KKEEEK EE } 


program RAWCOOKP; 
Uses Crt, Dos; { CRT and DOS units } 


const STANDARDIN = 0; { handle 0 is connected with Standard input } 
STANDARDOUT = 1; { handle 1 is connected with Standard output } 


var Keys : char; { only needed for Demo program } 


{RRR K HR KK RRR RK KH RK KERR EK KKK KIRKE RK KKK IKKE KEKE RE KKK KKK KEKE KEK KKEKKKEKKEKE | 


{* GETMODE: read attribute of device driver in a 
{* Input : the handle passed must be connected to device addressed *} 
{* Output : the device attribute = 


{ERK KKR RRR EKER KK KKEK KKK KK KKK KKK KKK RK KK KKK EK RRR KKK KKK KKK KEKKKEKEKEKKKK KE | 


function GetMode (Handle : integer) : integer; 


var Regs : Registers; { register-Variable for Interrupt call } 
begin 

Regs.ah := $44; { Function number for IOCTL: Get Mode } 
Regs.bx := Handle; 

MsDos( Regs ); { Call DOS-Interrupt 21H } 
GetMode := Regs.dx { Pass device attribute } 
end; 


{ BERK HKKKAKK KA KKK KKK RRR KK HARK KKK KKK KK HKKKKAKHKK KAKA KKK KKK KHKKKKKKKEKK KE | 


{* SETRAW : Change a character driver into RAW-Mode *} 
{* Input : the handle passed must be connected with *) 
{* addressed device >] 
{* Output : none *} 


{ HARK ARKH KAR KKK AKER RK KK KKK KKK KER KEK KKK KEK KKK ERK KKK KKKK KK KKK KKK KEKE EK } 


procedure SetRaw (Handle : integer); 


var Regs : Registers; { register-Variable for Interrupt call } 
begin 

Regs.ax := $4401; { Function number for IOCTL: Set Mode } 
Regs.bx := Handle; 

Regs.dx := GetMode (Handle) and 255 or 32; { new device attribute } 
MsDos( Regs ); { Call DOS-Interrupt 21H } 
end; 


{ EEK KKKKEKEKKEKKKKKEKKEKERK KEKE KEK EK EEKKEKKEKKKKKKKEKKEKEKKKKEKEKKAEKEEKAKKKEKEKE } 


{* SETCOOKED : Change a character driver into the COOKED-Mode iol 
{* Input : the handle passed must be connected with the *} 
{* device addressed ia 3 
{* Output : none *} 


[RRR R RK KEK RRR KER KEK AK KKK KKK KKK KKK RE KKK KKK ERE KEK KKK KEKE KKK KEKKKEKKK EE | 


procedure SetCooked (Handle : integer); 


var Regs : Registers; { register-Variable for Interrupt call } 


\ 
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begin 

Regs.ax := $4401; { Function number for IOCTL: Set Mode } 
Regs.bx := Handle; 

Regs.dx := GetMode (Handle) and 223; { new device attribute } 
MsDos( Regs ); { Call DOS-Interrupt 21H } 
end; 


{FARR HHHIKRKKK KKK KKK HK IKARIA KK KEK KKK IKKE KKK KKKKKKKK KKK KK KK 


{* TESTOUTPUT : Output a Test-String 1000 times on the Standard *} 
{* output device *} 
{* Input : none *} 
{* Output : none *) 


procedure TestOutput; 


var Regs : Registers; { register-Variable for Interrupt call } 
LoopCnt : integer; { Loop variable } 
Test : string[9]; { The Test-String for output } 
begin 
Test := ‘Test.... '? 
Regs.bx := STANDARDOUT; { output on the Standard output device } 
Regs.cx := 9; { Number of characters } 
Regs.ds := Seg(Test); { Segment address of the text } 
Regs.dx := Ofs(Test)+1; { Offset address of the text } 
for LoopCnt := 1 to 1000 do 
begin 
Regs.ah := $40; { Write function number for handle } 
MsDos( Regs ); { Call DOS-Interrupt 21H } 
end; 
writeln; 
end; 


{ BARRA RK RK RRR KK IKK KKK IKKE KIRKE KK IKK KKK ERR RK KKK KKK KKKKKKKKK KKK) 


{* MAIN PROGRAM i 


{BARR HI IK KIKI IKK IKI IKK IKK KIKI II KKK IIR KIKI KKK KIKKK KAKA AK KK KH 


begin 
Cirser: { Clear screen } 
writeln('RAWCOOK (c) 1987 by Michael Tischer' #13#10); 
writeln('The Console driver is now in RAW-Mode. Control keys such as <Ctrl><C>'); 
writeln('are not recognized during output. Press a key to display a text on 


*#13#10) ; 

writeln('the screen, and try stopping the display by pressing <Ctrl><C>'); 
Keys := ReadKey; { wait for key } 
Set Raw (STANDARDIN) > { Console driver in RAW mode } 
TestOutput; { Output Test-String 1000 times } 
ClirSer: { Clear Screen } 
while KeyPressed do 

Keys := ReadKey; { Empty keyboard buffer } 


writeln('The Console driver is now in COOKED mode. Control keys such as'); 
writeln('<CTRL><C> are recognized during output'); 
writeln('Press a key to start, then press <Ctrl><C> to stop the display'); 


Keys := ReadKey; { Wait for key } 

Set Cooked (STANDARDIN) ; 

TestOutput; { Output Test-String 1000 times } 
end. 
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C listing: RAWCOOK.C 


[RRR KKK KEKE KKK KEKE KEK KEKE KEK KKK ERE KKK IKI AKKEEKEKEKEKK EK / 


/* RAWCOOK */ 
/* es cms i acs cmp aa ci i wai cn msc ss ses snes cose sce “oe cue ss nt ns Sis Cs cao eae wm Gan ees‘ ech mace msn ci aca GSES ns ss cebu comes x/ 
/* Task : provides two functions for af 
/* switching a character device driver into the RAW */ 
/* or into the COOKED mode =f 
/* si ae ia: a ins iss ms ‘im ‘i ‘etm iio S'S snc ak ms wi ‘aos ie is cS um asks mn cs sens es cm einai cs ces x a wn as cess ems ccm i es Ses */ 
/* Author : MICHAEL TISCHER */ 
/* developed on : 08/16/87 i A 
/* last Update : 04/08/89 */ 
FR a a a ei oe */ 
/* (MICROSOFT C) */ 
/* Creation : MSC RAWCOOKC; sad 
/* LINK RAWCOOKC; */ 
/* Call : RAWCOOKC st 
/* sn enc ik er sc ses cs cm cs sem cin‘ Ss ss Sas ce id ns‘ re‘ ins ‘cae et sb ls tems a nd en eve Ss ash toe ns sas mes Ga mes se oe eo Se */ 
/* (BORLAND TURBO C) */ 
it Creation : through command RUN in the menu */ 


[RRR KIKI HAKKAR KKK KIKI IKK KKK IKKE KKK AKI KKK IKKE EKKEKEKKE / 


#include <dos.h> . /* include Header files */ 
#include <stdio.h> 
#include <conio.h> 


#define STANDARDIN 0 /* handle 0 is the Standard input device */ 
#define STANDARDOUT 1 /* handle 1 is the Standard output device */ 


[RRR IKK KIKI EK KKK KEK IKK IK IKK IKE KIKI EKA EKER KK KAKEREKEKEKKAE / 


/* GETMODE: read the attribute of an device driver ia & 
/* Input : the handle must be connected with the addressed device a 


/* Output : the device attribute */ 
[RRA HEE KKK KEK KKK AKER KKK KKK KK IRE KKK KEE KKK KKKE EEK KKKAKKKKKKKKKKK / 


int GetMode (Handle) 


int Handle; /* points to the character driver */ 
{ 
union REGS Register; /* register-Variable for Interrupt call */ 
Register.x.ax = 0x4400; /* Function number for IOCTL: Get Mode */ 
Register.x.bx = Handle; 
intdos (&Register, &Register); /* Call DOS-Interrupt 21H */ 
return (Register.x.dx)?; /* Pass device attribute */ 


} 


[RRR K KEKE KK KEKE KK KKK KEKE KK KEKE KEKE KEK KEKE KKK KK EK / 


/* SETRAW : Change a character driver into RAW mode */, 
/* Input : the handle passed must be connected with the addressed */ 
[= device x/ 
/* Output : none */ 


[RRR KIEKKKKKKEKKKIKIEKIK KIKI IKK IKEA KEKE KEKE KKK KEKE KEKEKKKKEKKKE EK / 


int SetRaw (Handle) 


int Handle; /* points to the character driver */ 
{ 

union REGS Register; /* register-Variable for Interrupt call */ 
Register.x.ax = 0x4401; /* Function number for IOCTL: Set Mode */ 
Register.x.bx = Handle; 

Register.x.dx = GetMode (Handle) & 255 | 32; /* new device attribute */ 
intdos (&Register, &Register); /* Call DOS-Interrupt 21H a7 
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[RII IIIT TTT II IK I IIR IT KIKI I IA IT IIA IA IAAI II AIA AKA IAI KEK AEA AKA / 


/* SETCOOKED: Changes a character driver into the COOKED mode */ 
/* Input : the handle passed must be connected with the device */ 
[* addressed af 
/* Output : none */ 


[BR IIH III KIKI TK IKI IIH KK RK IKK III RIDA KIT IAEA KIKI KKK ARKH EE / 


int SetCooked (Handle) 


int Handle; /* points to the character driver */ 
{ 
union REGS Register; /* register-Variable for Interrupt call */ 
Register.x.ax = 0x4401; /* Function number for IOCTL: Set Mode */ 
Register.x.bx = Handle; 
Register.x.dx = GetMode (Handle) & 223; /* new device attribute */ 
intdos (&Register, &Register); /* Call DOS-Interrupt 21H */ 


} 


[RRR ERK IKKE KKK EK KK III KR KKK II IKK IK KKK IKK HK IKK KIKI KK EEK KIK KEK KEKE / 


/* TESTOUTPUT: outputs a Test-String 1000 times on the Standard */ 
f* output device a/ 
/* Input : none */ 
/* Output : none */ 


[RARER REIKI IKK KAK KKK K ARK KARE KAR EKER KEK KEK KEK KEK KKK KKK KKKEKKKE / 


void TestOutput () 


{ 
int i; /* Loop Variable */ 


Static char Test[] = "Test.... "3 /* the text for output */ 


printf ("\n"); 

for (1 = 07; i < 1000; i++) /* output 1000 times */ 
fputs (Test, stdout); /* Output String on the Standard output. */ 

printf ("\n"); 

} 


[RRR RIKI IK IKI II KKK KIKI AKER IKK KKK KEK KKK KKK KEKE KKE KKK KK KK / 


o> MAIN PROGRAM slag A 


[RRR IRI KIKI KIRK IKK IKK KK KHIR IR IKK KKK KKK KKK KKK KKK ERK KKK KE KEKE KEKE / 


void main () 


{ 
printf ("\nRAWCOOK (c) 1987 by Michael Tischer\n\n"); 


printf ("The Console Driver (Keyboard, Display) is now in "); 

printf (“RAW Mode.\nDuring the following output control characters, \n"); 
printf("such as <CTRL-S> will not be recognized.\n"); 

printf ("Try it.\n\n"); 

printf ("Please press a key to start..."); 


getch(); /* wait for key */ 
Set Raw (STANDARDIN) ; /* Console driver into RAW mode */ 

TestOutput ()}; 

while (kbhit ()) /* in the meantime remove key codes from */ 
getch(); /* keyboard buffer */ 


printf ("\nThe console driver is now in COOKED mode. "); 

printf ("Control keys such as\n<CTRL-S> are recognized during "); 
printf ("output and answered accordingly! \n"); 

printf ("Please press a key to start ..."); 

getch(); /* wait for key */ 
Set Cooked (STANDARDIN) ; /* Console driver in the COOKED mode */ 
TestOutput (); 
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6.6 


File Management in DOS 


The DOS file management functions are among the most basic available to the 
programmer. These functions are used to: 


° Create and delete files 
° Open and close files 
° Read from and write to files 


Operating systems such as DOS provide the programmer with functions for file 
management. For example, DOS provides functions which return special file 
information or functions to rename a file. One peculiarity of DOS is that these 
functions exist in two forms because of the combined CP/M & UNIX 
compatibility. For every UNIX compatible file function, there is also a CP/M 
compatible file function. 


FCB functions 


The CP/M compatible functions are designated as FCB functions since they are 
based on a data structure called the FCB (File Control Block). DOS uses this data 
Structure for information storage during file manipulation. The user must reserve 
space for the FCB within this program. The FCB permits access to the FCB 
functions which open, close, read from and write to files. 


Since the FCB functions were developed for compatibility with CP/M's functions, 
and since CP/M has no hierarchical file system, FCB functions do not support 
paths. As a result, FCB functions can only access files which are in the current 
directory. 


UNIX handle functions 


6.6.1 
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The UNIX compatible handle functions don't have this problem. With these 
functions, a handle is used to identify the file to be accessed. The DOS stores 
information about each open file in an area that is separate from the program. 


Handle Functions 


It is easier for the programmer to access a file using the handle functions than to 
access a file using the FCB functions. The handle functions do not require a 
programmer to use a data structure for file access like the FCB functions do. In a 
manner similar to the functions of the UNIX operating system, file access is 
performed using a filename. The filename is passed as an ASCII string when the 
file is opened or first created. This must be performed before the first write or read 
operation to the file. In addition to the filename, it may contain a device 
designator, a pathname and a file extension. The ASCII string ends with the end 


Abacus 


FILES 
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character (ASCII code 0). After the file is opened, a numeric value called the handle 
is returned. Any further operations to this file are performed using this 16-bit 
handle. For a subsequent read or write operation, the handle and not the filename is 
passed to the appropriate function. 


For each open file, DOS saves certain information pertaining to that file. If the 
FCB functions are used, DOS saves the information in the FCB table within the 
program's memory block. When the handle functions are used, the information is 
stored in an area outside of the program's memory block in a table that is 
maintained by the DOS. The number of open files is therefore limited by the 
amount of available table space. The amount of table space set aside by DOS is 
specified by the FILES parameter of the CONFIG.SYS file: 


FILES = X 


In DOS Version 3.0, this maximum is 255. If you change the maximum number 
of files in the CONFIG.SYS file, the change will not go into effect until the next 
time that DOS is booted. 


While the FILES parameter specifies the maximum number of open files for the 
entire operating system, DOS limits the number of open files to 20 per program. 
Since five handles are assigned to standard devices such as the keyboard, monitor 
and line printer, only 15 handles are available for the program. For example, if a 
program opens three files, DOS assigns three available handles and reduces the 
number of additional handles available by three. If this program calls another 
program, the three files opened by the original program remain open. If the new 
program opens additional files, the remaining number of handles available 1s 
reduced even further. 


In addition to the standard read and write functions, there is also a file positioning 
function. This lets you specify an exact location within the file for the next data 
access. Knowing both a record number and the length of each data record allows 
you to specify the position to access a particular data record: 


position = record number * length of record 


This function is not used during sequential file access since DOS sets the file 
pointer during opening or creation of a file to the first byte within the file. Each 
subsequent read or write operation moves the file pointer by the number of bytes 
read towards the end of the file so that the next file access starts where the previous 
one ended. 


The following table summarizes the handle functions. For a more detailed 
description of these functions, see Appendix C. 
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6.6.2 
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Read/Write modifications & date/time of file 


Here are a few general rules to follow when using these functions: 


Functions which expect a filename or the address of a filename as an argument 
(e.g., Create File and Open File) expect the segment address of the name in the DS 
register and the offset address in the DX register. If the function successfully 
returns a handle, it is returned in the AX register. 


Functions which expect a handle as an argument expect it in the DX register. After 
the call, the carry flag indicates if an error occurred during execution. If an error 
occurs, the carry flags is set and the error code is returned in the AX register. 


Function 59H of DOS interrupt 21H returns very detailed information concerning 
errors which occur during disk operations. This function is available only in DOS 
Versions 3.0 and higher. 


FCB Functions 


As discussed earlier, DOS uses an FCB data structure for managing a file. The 
programmer can use this data structure to obtain information about a file or change 
information about a file. For this reason we shall examine the structure of an FCB 
before discussing the individual FCB functions. 


The FCB is a 37-byte data structure which can be subdivided into different data 
fields. The following figure illustrates these fields. 
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+ 10H} File size (2 words) 
Modification date (1 word) 


+ 16H |] Modification time (1 word) 
Current data record number(l byte) 


+ 21H] Data record number for (2 words) 
random access 


Structure of an FCB 


Notice that the name of the file is found beginning at offsets 01H through OBH of 
the FCB. The byte at offset 0 is the device indicator, 0 is the current drive, 1 drive 
A, 2 drive B, etc. 


The filename which begins at offset 1 is an ASCII string. It may not contain a 
pathname since it's limited to 8 characters. For this reason, the FCB functions can 
access only files in the current directory. Filenames shorter than eight characters 
are padded with spaces (ASCII code 32). The file extension, if any, occupies the 
next three bytes of the FCB. 


At offset OCH of the FCB is the current number of the block for sequential file 
access. The two bytes at offset OEH are the record size. The four bytes at offset 
10H are the length of the file. 


The date and time of the last modifications to the file are stored beginning at offset 
14H of the FCB in encoded form. 
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1514131211109 8 7 6 5 4 3 2 1 9 bit 


SSS 

| Hour Minute Seconds in 
2-second 
increments (e.g., 
13 means 26) 


1514131211109 8 7 6 5 4 3 2 1 «© bit 


SS 


Year (relative to 1980) Month Day of month 


Format of time and date stamps in the FCB 


An eight-byte data area follows and is reserved for DOS (no user modifications 
allowed). The use of this area varies from one version of DOS to another. 


Following this reserved data area is the current record number which is used in 
connection with the current block number to simulate CP/M operations. 


Random files 


The last data field of the FCB is used for a type of access in which the data within 
the file may be retrieved or written in a non-sequential order. This field is four 
bytes long. If a record is equal to or larger than 64 bytes, only the first three bytes 
are used for indicating the current record number. All four bytes of this field are 
used for records smaller than 64 bytes. 


Extended FCB 


Besides a standard FCB, DOS also supports the extended FCB. Unlike normal 
FCBs, extended FCBs access files with special attributes, such as hidden files or 
system files. Furthermore, they permit access to volume names and subdirectories 


(this doesn't mean that you can access files in other directories besides the current 
directory). 


An extended FCB is similar to a standard FCB, but it's seven bytes larger. These 


seven bytes are located at the beginning of the data structure. All subsequent fields 
are therefore displaced by seven bytes. 
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PF (1_ byte) 


Reserved (0) (5 bytes 
File size (2 words 
Modifications-time (1 word) 
Reserved (8 bytes) 


Data record number (2 words 


Structure of an extended FCB 


~~~" 


— 


The first byte of an extended FCB always contains the value 255 and identifies this 
as an extended FCB. Since this address contains the device number in a normal 
FCB and can therefore not contain the value 255, DOS can tell the difference 
between a normal and an extended FCB. The next five bytes are reserved 
exclusively for the use by DOS. They should not be changed. The seventh byte is 
a file attribute byte. See Section 6.1.2 for the details of the file attribute byte. 


Now that you're familiar with the FCB structures, the next section focuses on 
using FCBs for accessing files. 


FCB and file access 


Before accessing a file, an FCB must be built in the program's memory area. The 
area can be reserved within the data segment of the program or by allocating 
additional memory using another DOS function (see Section 6.9). 


Although it is possible to write the data directly into the FCB, it is better to use 
one of the appropriate DOS functions to do this. 


For example, to set the filename in the FCB you can use DOS function 29H. The 
function number is passed in the AH register. The address of the FCB is passed in 
the ES:DI register pair. The address of the filename is passed in the DS:SI register 
pair. The filename is an ASCII string terminated by the end character (ASCII code 
0). The AL register contains flags for converting the filename and are discussed in 
more detail in Appendix C. 


Open FCB 


After the FCB is properly formatted the file can be opened or created using a DOS 
function. When this happens DOS stores information about that file in the FCB 
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DTA 


such as the file size, date and time of file creation, etc. At this point the FCB is 
considered opened. 


By default, the record length is set to 128 bytes when the FCB is opened. To 
override this record length, store the desired record length at offset OEH of the FCB 
after it is opened. Otherwise the default length will be used. 


For record lengths greater than 128 bytes, the record buffer also known as the 
DTA, or Disk Transfer Area must be moved to accommodate the longer record 
size. Normally, DOS builds the DTA in the PSP (Program Segment Prefix). 
Accessing the file using the default DTA for a record length greater than 128 bytes 
would overwrite some of the other fields in the PSP. 


The most convenient way to select a new DTA is to reserve the space in the 
program's data segment. To change the address of the DTA use DOS function 
1AH. The address of the new DTA is passed in the DS:DX register pair. DOS 
assumes that you have set aside an area large enough to accommodate your largest 
record length so you don't have to specify the new length. 


File access 
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For sequential file access, processing begins at the first record in the file. DOS 
maintains a record pointer in the FCB to keep track of the current record within the 
file. Each time the file is accessed, DOS advances the pointer so that the second, 
third, fourth, etc record is processed in order. 


For random file access, the records can be processed in any order. The position of 
each record relative t . .-> beginning of the file determines its record number. This 
record number is then assed to DOS to access a specific record. The last field of 
the FCB is used to specify the record number to DOS. ; 


It's also possible to change from sequential access mode to random access mode 
and vice versa since processing depends on a specific DOS function to access the 
file. In effect, there are two sets of independent functions, one for sequential access 
and one for random functions. | 


Following is a list of all of the FCB functions of DOS interrupt 21H. A more 
detailed description of the functions is found in Appendix C. 
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Set DTA address 

Random Read (of record) 

Random Write (of record) 

Determine file size 

Set record number for random access 
Random read (one or more records) 
Random write (one or more records) 
Enter filename into FCB 


mr 
iY) 
Ww 
nv 


Some basic rules about these functions should be mentioned here: 


Using the FCB functions, you can access several files, each with their own unique 
FCB. To tell DOS which file is to be accessed, pass the address of the file's FCB 
in the DS:DX register pair. 


Most of the functions return an error code in the AL register or the value zero if 
the function was successfully completed. For functions which open, close, create 
or delete a file, a code of 255 is returned if an error occurs. The other functions 
return specific error codes. More detailed information about these errors can be 
determined by calling DOS function 59H but is available only in versions of DOS 
V3.0 or later. 


Handles vs. FCBs 


After the two groups of functions made available by DOS have been presented, the 
advantages and disadvantages of the individual functions should be discussed 
briefly. For those who want to convert a program from the CP/M or UNIX 
Operating systems into DOS, the choice will be easy, but for those who want to 
develop a new program under DOS, this discussion can help in your deciding on 
which set of functions to use. 


Handles 


There are two main advantages to using handle functions. The first is the 
capability to access a file in any subdirectory of the disk. The second is that the 
handle functions are not limited to the number of FCBs which can be stored in a 
program's memory space. 


There are a number of additional considerations. You can access the name of a disk 
drive only by using an FCB. When the FCB is opened, you can easily determine 
its file size and the date of the last modification. The handle functions 
automatically provide an area large enough to accommodate the records in the file. 


As you can see there are arguments for and against using either the FCB functions 
or the handle functions. For future versions of DOS, the handle functions will play 
a more important role and the importance of the FCB functions will diminish. 
This is reason enough to use the handle functions for your new program 
development. 
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6.7 Accessing the DOS Directory 
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There are two groups of DOS functions for working with directories. The first 
group is used to manipulate the subdirectories and the second to search for files on 
the mass storage devices. 


With DOS Version 2.0 came the introduction of subdirectories. A mass storage 
device could be logically divided into smaller subdirectories which could in turn be 
further subdivided. In effect this organization created a directory tree. 


Main directory 


OSHT) |AUTOEXEC.BAT| [COMMAND.COM 
START.BAT INSTALL.BAT 


WKSHT1 WKSHT2 


Directory, subdirectory 


< 
ote 


File 


Directory tree 


In this directory tree, the names and numbers of subdirectories are not static. 
Therefore there must be a way to add, change and delete entries on the tree. Other 
functions must be available to set the current directory so that a complete 
pathname is not required for all file accesses. 


At the user level the MD, RD and CD commands can be used to make a directory, 
remove a directory and change a current directory. Internally, these commands are 
performed with functions 39H, 3AH and 3BH of DOS interrupt 21H. 


All three functions use identical calling conventions. 


The function number is passed in the AH register. The address of the path is passed 
in the DS:DX register pair. The path is a string and may be a complete path 
designation including a preceding drive letter followed by a colon (a device name) 
and terminated by ASCII code 0. If the device name is omitted, the current device 
is the default. 
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Following execution, the carry flag indicates the return code. If the carry flag is 
reset (0), then execution was successful. If the carry flag is set, then an error 
occurred and the error code is passed back in the AX register. 


Function 39H creates or makes a new directory (Make Directory). The name for the 
new directory is specified as the last element in the path. An error will be returned 
by the functions if one or more of the directories specified in the path do not exist, 
if the new directory name already exists or if the maximum number of files in the 
root directory is exceeded. 


Function 3AH deletes or removes a directory (Remove Directory). An error will be 
returned by the function if the target directory is not empty or the specified 
directory does not exist in the current path. 


Function 3BH changes the current directory (Change Directory). An error is 
retumed if the directories named in the path do not really exist. 


Function OEH sets the default disk drive. Besides the function number in the AH 
register, only the device code of the new current device must be passed in the DL 
register. Code 0 stands for the device A, 1 for B, 2 for C, etc. 


Directory specification 


Before specifying the current directory using function 3BH, it is sometimes 
necessary to find the current directory. DOS makes function 47H available to the 
programmer for this purpose. Since it can return the path of the current directory 
for any device, the device number must be passed to the function. If this is the 
current device, the value 0 must be passed in the DL register. For all other devices, 
the value 1 must be passed for drive A, 2 for B, 3 for C, etc. 


Besides the device code, the function must also have the address of a 64-byte buffer 
within the user program. The DS register contains the segment and the SI register 
holds the offset address of this buffer. After the function call this buffer contains 
the path designation of the current directory, terminated with the end character 
(ASCII code 0). The path designation cannot be preceded by the device name or the 
\ character. If the current directory is the root directory, the buffer contains only the 
end character. If a device code unknown to DOS was passed during the function 
call, the carry flag is set and the AX register contains the error code OFH. 


Let's consider the functions for searching for one or more files in the current 
directory on the current device. Again the parallel between handle and FCB 
functions appears. Two function groups exist to search for files. The group of 
FCB functions has the disadvantage that they limit the search to files in the current 
directory of a certain device, while handle functions allow searching for files in any 
directories of any devices. The term "handle" functions doesn't really fit these 
functions since they are not addressed with a handle. This designation originated 
with the introduction of subdirectories (and therefore the handle functions) in DOS 
Version 2.0. Version 1.0 offered only the FCB functions. 
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6.7.1 Searching for Files using FCB Functions 
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This method of file search uses functions 11H and 12H. Using them you can 
search for files with a fixed name or files with a filename extension. Function 11H 
finds the first file in the current directory. Function 12H finds all other additional 
files. The FCBs play a significant role since they mediate between the calling 
program and the two functions. Let's see how we can search for files in a directory: 


First the program must reserve space for two FCBs. This is done either by 
reserving memory in the data area of the program, or by requesting memory from 
DOS using function 48H. The programmer can use either normal or extended - 
FCBs. Extended FCBs offer the advantage of being able to search for files with 
special attributes (system or hidden), volume names and subdirectories. The 
filename for which the search will be made is specified in one of the FCBs. DOS 
places the name of the file(s) that it finds in the other FCB. To differentiate 
between the two FCBs, they are designated with the names Search FCB and Found 
FCB. 


The address of the Found FCB must be passed to DOS using function 1AH. The 
Found FCB becomes the new data transmission area (DTA) when this function call 
occurs. This area is important for these two functions as well as all other functions 
which transfer data between computer and disks. For this reason function 2FH 
should determine the address of the current DTA before activating the new DTA. 
When the file search ends, the DTA can be restored to its original state using 
function 1AH. 


After the DTA is set to the Found FCB, the next step is to place the name of the 
file you are looking for into the Search FCB. For a more general search, the 
wildcards * and ? may be used. You can transfer the filename directly or transfer it 
using function 29H. If you want to search through all files, use the filename *.*. 
If an extended FCB is used, you may insert an additional value into the attribute 
field of the Search FCB to limit the search to files with certain attributes only (see 
Section 6.12 for more information on the various attributes). 


This concludes the preliminary work. The file search can begin with the current 
directory. For this purpose, function 11H is called with the function number in the 
AH register, the segment address of the Search FCB in DS and the offset address in 
the DX register. If the system finds a file with the indicated name, the AL register 
contains the value 0 after the function call. If the filename wasn't found, the AL 
register contains a value of 255. The found filename and its attributes (if extended 
FCBs are used) can be read from the Found FCB. For additional searches, function 
12H (not function 11H) is called. Function 12H's register contents during call and 
return are similar to function 11H. If it returns the value 255 in the AL register 
during one of the calls, the search has ended. 
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6.7.2 Searching for Files using Handle Functions 


Working with handle functions is easier than working with the FCB functions. 
There are functions for searching for the first file (the 4EH function) and 
subsequent files (the 4FH function). Both functions return the information to the 
DTA. For this reason the DTA should be moved into an area accessible to the 
current program before calling either of these functions. This area must have at 
least 43 bytes available. As mentioned in connection with the FCB functions, the 
DTA should be restored to its original address after the search ends. 


During the call of the 4EH function, the function number is passed in the AH 
register, the attribute in the CX register and the address of the file to be found in 
the DS:DX register pair. The filename is a series of ASCII characters, terminated 
with an end character (ASCII code 0). In addition to a device name, you may add a 
complete path designation and the wildcard characters * and ?. If a path is not 
specified, DOS assumes that the search should be made in the current directory of 
the indicated device. If a device is not specified, the search proceeds on the current 
device. After the function call, the carry flag indicates whether a file was found. If 
the file couldn't be found, the carry flag is set, and the AX register contains an 
error code. An error code of 2H is returned if the indicated path does not exist. If no 
file could be found, an error code of 12H is returned. If the carry flag is reset, the 
DTA contains the information about the file found. It has the following structure: 


JAddress _| 
L_+00H 


+00H 


Function 4FH executes any further searches. The function number is passed in the 
AH register, and no other parameters are required. The carry flag indicates if there 
are additional files in the current directory to which the search may be applicable. 
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Demonstration programs 


The three programs below read directory entries and display them on the screen 
using one of the handle functions. You'll find the display more user friendly than 
the DOS DIR command: the files appear in a window, and the filename display 
stops as soon as the window is filled with filenames. This permits easy reading of 
filenames. By pressing any key, the program displays any additional pages of 
filenames. 


All three programs are designed on the same basic principle: first the main 
program determines the search path. It contains the names of the directories in 
which the search should be made for the files, the names of the files and the device 
where the directory is located. This name can contain wildcards (* and ?) to search 
for several files at the same time. If the user does not indicate a search path, the 
program defaults to the search path "*.*". This displays all files in the current 
directory of the current device, as well as the hidden attribute files. 


After the program determines the search path, a routine coordinates the loading and 
display of individual directory entries. First a routine creates the display window on 
the screen for individual entry output. Then a search proceeds for the first entry 
using DOS function 4EH. If an entry is found, the screen displays the entry. 
Function 4FH searches for all subsequent entries and displays them in the window. 


The bottom line of the display window moves up one line with each new line 
displayed. Once the entire window fills with data, any further display of entries 
stops until the user presses a key. After all entries in the selected directory have 
been displayed, the number of files is displayed and the program ends. 


BASIC listing: DIRB.BAS 
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LOD ERR KKKHKKE KKH K EEK KEK KEK KEK KEKE KEK KEK KEEKKEKEKREKKKKKEKEKKKKKEEKKKKEK 


110 '* DIRB = 
VDD OF en eee ce aco ce ce ee ee me ee ee a ee ee a a oes Oe a a en on a aS nt 
130 '* Task : display all files in a directory ae 
140 '* in a window on the display a 
160 ** Author : MICHAEL TISCHER iss 
170 '* developed : 07/23/87 cles 
180 '* last Update : 04/08/89 ally 
190 PKK K KK KKK KKEK KKK KKK KKK KK KEKKKKKKKKEEKKKEKKEKKKKKKKEKKKEEKEKKEKKEKKKKKKE 


200 ! 

210 CLS : KEY OFF 

220 PRINT"WARNING: This program can be run only if GWBASIC was started" 
225 PRINT" from the " 

230 PRINT"DOS level with the <GWBASIC /m:60000> command.“ : PRINT 

240 PRINT"If this is not the case, please enter <s> for Stop." 

250 PRINT : PRINT"Otherwise press any key ..."7 

260 AS = INKEYS : IF AS = “s" THEN END 

270 IF AS = "" THEN 260 


280 GOSUB 60000 ‘Install function for calling interrupt 
290 CLS 

300 PRINT "DIR (c) 1987 by Michael Tischer" 

310 PRINT 


320 PRINT“Please input the search path for the file." 

330 PRINT“Example: If all files with the extension .BAT in the Root" 

340 PRINT* directory of the disk in drive A should be displayed, “ 
350 PRINT" then please input A:\*.BAT." 

360 PRINT"With a blank input, all files in the current directory " 
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370 PRINT"“are displayed." : PRINT 


380 INPUT “Search Path: ",DIRS ‘Input Search Path 

390 IF DIRS = "" THEN DIRS = "* *" ‘search in current directory 
400 ENTRY$ = 14 ‘14 Display entries in window 
410 GOSUB 50000 ‘Input Directory and output 

420 END 

430 ! 

50000 OHH KKH HK IK KKK IKK TKK KKK KKK IKK KKK KKK KI KKK KEKKKKEKKKKKKEKS 
50010 '* Input one Directory and display ae 
50020 '*----~---------~----—---- - - - - enn = 
50030 '* Input: DIR$ = the search path =“ 
50040 '* ENTRY% = Number of entries in the window a 
50050 '* Output: none = 
50060 OHH KKK HHH KKK IK III KIKI IKK III KIKI KKK KKK KKH KKK KEKE EKKKEAKKKKEKS 
50070 ! 

50080 DIM MONTHS [11] ‘accepts names of months 


50090 RESTORE 50600 

50100 FOR I% = 0 TO 11 : READ MONTHS[I%] : NEXT 

50110 INR% = &H21 ‘Call DOS-Interrupt 21H 
50120 FCT% = &H2F ‘Get function number for DTA 
50130 CALL IA(INR%&, FCT%, 2%, OFSHI%, OFSLO%, 2%, 2%, 2%, 2%, 2%, 2%, DIASEGS, 2%) 
50140 DTAOFS% = OFSLO% + OFSHI%$ * 256 

50150 CLS 

50160 OFFSET% = INT((20 - ENTRY%) / 2) + 1 ‘Start line of window 
50170 LOCATE OFFSET%,14 


50180 PRINT TAB(14) °—— y,————_p-_____-- ——____,-__" 


50190 PRINT TAB(14)"| Filename | Size | Date | Time {| RHSVD | ** 
50200 PRINT TAB (14) °|————__- + + t+ ee 
50210 FOR I% = 1 TO ENTRYS% ‘output a line for every entry 

50220 PRINT TAB(14)"| | | | | is 
50230 NEXT ‘output next line 
50240 PRINT TAB (14) “| 4. fb. — 1 —- 1 —__ ]} " 
50250 NUMWIND% = -1 ‘Number of entries in window 
50260 NUMFND% = 0 ‘Number of entries found up to now 
50270 ATTRIBUTES = 255 ‘search for files with any Attribute 
50280 GOSUB 51000 ‘search for first entry 
50290 IF NOT (FOUNDIT%) THEN 50500 ‘no entry found --> finished 
50300 NUMFND% = NUMFND% + 1 ‘Increase number of entries found 
50310 NUMWIND% = NUMWIND% + 1 ‘Increase number of entries in window 
50320 IF NUMWIND%S <> ENTRY% THEN 50410 ‘window full? 
50330 LOCATE OFFSET%S+ENTRY%+4, 14 ‘Set Cursor to line under window 
50340 COLOR 0,7 ‘switch on inverse character display 
590350 PRINT" Please press any key my 

50360 AS = INKEYS : IF AS= "“" THEN 50360 ‘wait for a key 
50370 LOCATE ,14 ‘Cursor in line under window 
50380 COLOR 7,0 ‘switch on normal character color 
50390 PRINT STRINGS(51,"_"); 

50400 NUMWIND%S = -1 ‘the next entry is the first in the window 


50410 NUMBER = 1 : COLOURS = 7 
590420 ULR& = OFFSET% + 2 : LRR& = OFFSETS+ENTRY$% + 1 
50430 ULC% = 14 : LRC%& = 62 


50440 GOSUB 54000 ‘scroll window up 
50450 LOCATE OFFSETS+ENTRY$+2, 15 ‘Set Cursor to last window line 
50460 PRINT " | | | " 

50470 GOSUB 53000 ‘Output entry 
50480 GOSUB 52000 ‘Get next entry 
50490 IF FOUNDIT% THEN 50300 ‘continue if no entry is available 
50500 LOCATE OFFSETS+tENTRY%+4, 14 ‘Cursor in line under the window 
50510 COLOR 0,7 ‘switch on inverse character display 
50520 PRINT STRINGS(51,"_"); 

50530 LOCATE ,14 ‘Cursor in line under window 


50540 IF NUMFND% = 0 THEN PRINT" no file found"; : GOTO 50570 

50550 IF NUMFND% = 1 THEN PRINT" found one file"; : GOTO 50570 

50560 PRINT NUMFND%;"files found"; 

50570 COLOR 7,0 ‘switch on normal character color 
50580 RETURN 

50590 ! 

50600 DATA ae JAN" ; a FEB" , "MAR" ’ "APR" ; "MAY" ; « JUN", « JUL" ' "AUG" ; it SEP « 

590610 DATA "OCT", "NOV", "DEC" 
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50620 ' 

51000 CK RIKKI KKK KKK ERE KEKE KKK KE KEKE KK KEKE EKKEKKKEEKEKEKKKEKS 
51010 ‘* Search for first entry in a Directory = 
51020 ' *-------------- —- — = — rrr ” 
51030 ** Input: DIR$ = Search path x 
51040 '* ATTRIBUTES = Attribute of file a 
51050 '* Output: FOUND IT$% = -1 if entry found, otherwise 0 a 
51060 '* Info : the Directory entry is entered into Variable DTA% ws 
51070 '* “e 
51080 '* Z% is a Dummy-Variable ws 
51090 CHEEK KEKE KKEKEEKKKEK KKK KEKE KKK KK KKKEK KKK KKKEKKKEKKEKEKKKKKKKEKS 
51100 ' 

51110 DIRS = DIRS + CHR$ (0) ‘Put End character on search path 
51120 FCT% = &H4E ‘Search function number for first entry 
51130 INR%& = &H21 ‘Call DOS-Interrupt 21H 
51140 ATLO% = ATTRIBUTES AND 255 'LO-Byte of Attribute 
51150 ATHI% = INT(ATTRIBUTES% / 256) ‘HI-Byte of Attribute 
51160 OFSLO&% = PEEK (VARPTR (DIRS) +1) 'LO-Byte of Offset address 
51170 OFSHI% = PEEK (VARPTR (DIRS) +2) ‘HI-Byte of Offset address 
51180 CALL IA(INR&, FCT%, 2%, 2%, 2%, ATHI%, ATLO%, OFSHI%, OFSLO%, 2%, 2%, 2%, FLAGS%) 
51190 FOUNDIT%S = ((FLAGS% AND 1) = 0) ‘Test Carry-Flag 
51200 RETURN ‘return to calling program 
51210 ' 

52000 CMH HAKKAR KKK KKK KKKKKKKKKKKKKKKEKKKKKKKKKKEAKKEKKKEKEE LE 
52010 ** find next entry in Directory * 
52020 !*-~-------- nr xe 
52030 '* Input : DIRS = Search path iad 
52040 ‘* ATTRIBUTE% = Attribute of file ae 
52050 '* Output: FOUNDITS = -1 if file found, otherwise 0 *e 
52060 '* Info : the Directory entry is read into Variable DTA% mS 
52070 ‘* x 
52080 ‘* 2% is a Dummy-Variable “ 
52090 CHM KKK KKK KK KEK KKK KKK KEK KEK KKK KKK KK KEK EEK KEKE KK KEK KEKKKKKKKEKEKES 
52100 ! 

52110 FCT% = &H4F ‘Find function number for next entry 
52120 INR% = &H21 ‘Call DOS-Interrupt 21H 
52130 CALL IA(INR%&, FCTS, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, FLAGS$%) 

52140 FOUNDIT% = ((FLAGS% AND 1) = 0) ‘test Carry-Flag 
52150 RETURN "back to calling program 
52160 ' 

53000 eee ec cee eee ce cee eee eee eee eee eee eee SSeS eS eee eee ee eee ee ee ee 2 eee 
53010 '* Output a Directory entry from the DTA to the display si 
53020 '*-----------~--~—---——- — - rns x 
53030 '* Input: OFFSET% = first line of the Directory window x 
53040 '* ENTRY% = Number of entries in the Directory window *' 
53050.-** DTAOFS% = Offset address of the DTA = 
593060 ‘* MONTHS = contains the names of months ie 
53070 '* Output: none a 
53080 CHK KKK KKK KKK KIKI KK KKK KKK KKK KEKE KK KKK KEK KKK KKKKKKKKKKRKKKKKEKKEKKEKS 
53090 ! 

53100 DEF FNDTA(X) = PEEK(DTAOFS% + X) 

593110 DEF SEG = DTASEG% ‘Set Segment address of the DTA 
53120 LOCATE OFFSET%$+ENTRY%+2,15 ‘Output in the last line of the window 
53130 I% = 30 ‘Offset address in DTA for file names 
53140 WHILE FNDTA(I%) <> 0 ‘the END character terminates the name 
53150 PRINT CHRS (FNDTA(I%)); ‘output a character of the file name 
93160 1% = 1% + 1 ‘next character 
53170 WEND ‘End of Loop 
53180 LOCATE OFFSET%+ENTRY$%+2, 28 'Set Cursor to column 28 


53190 PRINT USING "#######"; FNDTA(26) + FNDTA(27) * 256! + FNDTA(28) * 
4096! + FNDTA(29) * 65536!; 


53200 DATE = FNDTA(24) + FNDTA(25) * 256 ‘Get Date 
53210 LOCATE OFFSET%+ENTRY$%+2, 36 ‘Set Cursor to Column 36 
53220 PRINT MONTHS[ (INT(DATE / 32) AND 15) - 1]; ‘Output name of month 
53230 PRINT"/";:PRINT USING "##";DATE AND 31; ‘Output day of month 
53240 PRINT USING "/####";INT(DATE / 512) + 1980; ‘Output year 
53250 LOCATE OFFSET%S+ENTRY$%+2, 49 ‘Set Cursor to column 49 
53260 FTIME = FNDTA(22) + FNDTA(23) * 256 ‘Get time 
53270 PRINT USING “##";INT(FTIME / 2048); ‘Output hour 


593280 PRINT ":"; 
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53290 PRINT USING "##";INT(FTIME / 32) AND 63; ‘Output Minute 
53300 LOCATE OFFSETS+ENTRY%+2, 59 ‘Set Cursor to column 59 
53310 FOR I% = 0 TO 4 ‘test Bits 0 to 4 of file attribute 
593320 IF (FNDTA(21) AND (2*1I%)) <> 0 THEN PRINT"X"; ELSE PRINT" “; 
53330 NEXT I% ‘test next Bit 
93340 DEF SEG : RETURN ‘back to calling program 
53350 '! 

54000 THREE K AK KK KKK KKKKREKEKKKKKKAEKKK EKER REKREKEKKKKEKAEN 
54010 '* Scroll current display page up or erase x 
54020 !*-------~------+--+-—-----— -- — + + - re eee =s 
54030 '* Input : NUMBER% = how many lines scrolled ~ 
54040 '* ULC% = column upper left ls 
54050 '* ULR$& = line upper left bey 
54060 '* LRC% = column lower right “s 
54070 '* LRR& = line lower right = 
54080 '* COLORS = color of erased line i 
54090 '* Output: none si 
594100 '* Info : If 0 is given for NUMBER%, the screen area *" 
54110 '* indicated is erased x 
54120 '* the Variable 2% is a Dummy nA 


54130 PHAM KIRK KKK IK KI KKK KKK KK IKE KEK KKK KIRKE KKK KEKE KKEEKKKKKEEKKEK! 


94140 ! 


54150 FCT%=6 ‘Function number for scrolling up 
54160 INR%=&H10 ‘Call BIOS-Video-Interrupt 16H 
54170 CALL IA(INR%, FCT%, NUMBER$, COLOURS, 2%, ULR%, ULC%, LRR%&, LRC%, 2%, 2%, 2%, 2%) 
54180 RETURN ‘back to calling program 
54190 ' 

60000 CR RK KIK KKK KIKI KKK KKK KKK KKK EKKKEKKKEEKKKKKKKKKKKKKKKK 
60010 '* Initialize Routine for Interrupt call ws 
60020 '*------~--~---~-----------~+----- -- - -- - -- - - - ne x 
60030 '* Input : none a 


60040 '* Output: IA is the Start address of the Interrupt-—Routine *! 
60050 CHK KKK KKK KKK KK EEK KKK KKK KEK KKK KKK KKK KK KKK KKK KKEKKEKEKKKKEEKAKKE | 
60060 ' 

60070 IA=60000! ‘Start address of the Routine in the BASIC~Segment 
60080 DEF SEG ‘Set BASIC-Segment 
60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 =: READ X% : POKE IA+I%,X% : NEXT ‘Poke Routine 
60110 RETURN ‘back to calling program 
60120 ! 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 

60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 

60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 

60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 

60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 

60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 

60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 

60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 

60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 

60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 

60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108,255 


One problem in the BASIC version of the directory listing occurs during the 
directory output. Functions 4EH and 4FH read the entry into the DTA. It would 
make more sense to move the DTA to a variable within the program (an integer 
array would be best) to make it easier for the routine which outputs the entry to 
access the data. BASIC's garbage collection feature makes this difficult. The 
integer array containing the DTA moves periodically in storage and the address of 
the DTA, stored internally in DOS, no longer corresponds with the address of this 
integer array. 


For this reason, the DOS function 2FH determines the DTA address. As the entries 
are displayed, this address accesses the DTA to determine the file information. 
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Pascal listing: DIRP.PAS 


{ REAR KKK KKEK KKK KEKK KKK KRKEK KKK KKK ERK KKK KKK KKK KK KIRK KEK KEK KEKE KKK KKKK KKK | 


{* DIRP *) 
{ *~~-—~---—~---~ ~~ + +--+ + + ee ee == *} 
{* Task : Display all files of any Directory, <] 
ee including Subdirectories and *} 
{* Volume Names *) 
{* fe ee ce ee ce ce se es me Se cs ee me E Seny  S  S  em D  MD nS nM SOD SO nS SG ET SD SH SE SEED SD SEED ND ee OR nD eee Seca emo *} 
{% Author : MICHAEL TISCHER a 
{* developed on : 7.8.87 *} 
{* last Update : 9.21.87 a 


{ FER RK KKK KK KEK EER KKK KEK KKK KER ERK RK KKK KKK KKK KKK ERE KK KKK KKEKEKKEKKKK EE | 


program DIRP; 


Uses {Turbo 4.0 Units} 
Cru, 
Dos; 
const ENTRY = 14; { Number of entries visible } 
type RegTyp = record 


ax, bx, cx, dx, bp, 
di, si, ds, es, flags : integer; 
{! Turbo 4.0 owners should use the Registers type from the DOS unit.} 
end; 


{** this is the format of a Directory entry *****} 
{** as returned by the functions 4EH and 4FH } 
DirBufTyp = record 
Reservebuf : array [1..21] of char; 
Attribut : byte; 


Zt ime : integer; 
zdate : integer; 
Datgrlo : integer; 
Datgrhi : integer; 
DatName : array [1..13] of char 
end; 
Path = string[65]; 
var DirBuf : DirBufTyp; { accepts a Directory entry } 
DatName : Path; { Files to be found } 


{KERR RRR RRR RK KEK ERK KKK RRR KKK KKK KKK RRR RIKER KK RK KKK KER KKK KKK KKK KER KKK KK} 


{* GETFIRST: read in the first Directory entry x} 
{* Input > none *} 
{* Output : true or false, depending if an entry was found *} 
1 =) 
{* Info : the entry is stored in Variable DIRBUF =) 


[BARRE KKK KKK KERR KKK KKK RK KKK KKK HH KKK HK KR KK KE KKK KKK KEKE EKKKKKKKEKK KK } 


function GetFirst (DateiName : Path; { files to be found } 
Attribute : integer) : boolean; { search Attribute } 


var Register : regtyp; { Register-Variable for call of Interrupt } 
begin 
DateiName := DateiName + #0; { terminate filename with NUL } 
Register.ax := S$4E shl 8; { Function number for search of first } 
Register.cx := Attribute; { Attribute, for which search is performed } 
Register.ds := seg(DateiName) ; { Segment address of filename } 
Register.dx := succ(ofs (DateiName) }); { Offset address of filename } 


msdos (Dos.Registers (Register));{ Call DOS Interrupt 21H (Turbo 4.0) } 
{NOTE:Turbo 3.0 users should change previous line to read msdos (Register};} 
{ defined in DOS unit.} 
if (Register.flags and 1) = 0 { Test Carry-Flag } 
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then GetFirst := true { Equal to 0 : file found } 


else GetFirst := false; { no file found 
end; 


[RRR KR RRR KKK KKK IKK RRR IRI ERK RE IKK IK KAKA KEKEKKEKKEKE | 


{* GETNEXT : read in the following Directory entry *) 
{* Input : none *} 
{* Output : true or false, depending if another entry was found *} 
ie *} 
{* Info : this function can only be called after a successful *} 
{* call of the function GETFIRST =) 
{* the entry is stored in the Variable DIRBUF *} 


LAH HRI KAKA KIKI KKK KHER EKER KERR KEKE KEKE KEKEKEREEKKKAK KKK KKKKKE | 


function GetNext : boolean; 


var Register : regtyp; { Register-Variable for interrupt call } 
begin 
Register.ax := S$4F shl 8; { Function number for next search } 
msdos (Dos. Registers (Register) )}; { Call DOS Interrupt 21H V 4.0} 


{NOTE: Turbo 3.0 users should change the previous} 

{line to read msdos (Register) ; } 

if (Register.flags and 1) = 0 { Test Carry-Flag } 

then GetNext := true { Equal to 0 : File found } 

else GetNext := false; { otherwise no file found } 
end; 


{BRR RK KKK RK HR K RRR ERK KKK RHE KKK KKK KKK KEK KKK EK KEK KEK KKK ERK KKK KE KKK EKER | 


{* PRINTDATA: Output information on an entry *} 
{* Input : none *} 
{* Output : none a 
{* Info : the information about the entry are taken by this i | 
{* procedures from Variable DIRBUF dD 


{RRR KRHA K RK KKK KEK KEK KEKE KKK KEKE KEKE KEKE KK KKKKKKEKEKKEKKKEEKKKKEKKKKKEKE | 


procedure PrintData; 


var Counter : byte; 
DataLenghtl, { both Variables are used } 
DataLenght2 : real; { to calculate file length } 
begin 
writeln; { the window is scrolled up by one line } 
Counter := 1; { begins with the first character of the name } 
while (DirBuf.DatName[Counter]<>#0) do { repeat up to NUL } 
begin 
write (DirBuf.DatName [Counter] ) ; { output characters of name } 


Counter := succ (Counter) { process next character } 
end; 

gotoxy (13, ENTRY); 

DataLenght1] := DirBuf.Datgrhi; { determine file length } 
if DataLenght1 < 0 then DataLenght1 := 65536.0 + DataLenghtl; 

DataLenght2 := DirBuf.Datgrlo; 

if DataLenght2 < 0 then DataLenght2 := 65536.0 + DataLenght2; 
write(‘'|', DataLenghtl * 65536.0 + DataLenght2:7:0); 

gotoxy (21, ENTRY); 

write('|'); 

case (DirBuf.Zdate shr 5 and 15) of { determine month } 

write (‘Jan'); 

write ('Feb')?; 

write ('Mar'); 

write ('‘Apr'); 

write ('May'); 

write ('Jun'); 

write (‘Jul'); 

write ('Aug'); 

write ('Sep'); 

write ('Oct'); 

write ('Nov'); 

write ('Dec') 


1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 


} 
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end; 

write ('/',DirBuf.Zdate and 31:2,'/'); { determine day } 

write (DirBuf.Zdate shr 9 + 1980:4); { determine year } 

gotoxy (34, ENTRY); 

write('"|*, DirBuf.Ztime shr 11:2, ‘:'); { determine hour } 

write (DirBuf.Ztime shr 5 and 63:3); { determine minutes } 

gotoxy (44, ENTRY); { evaluate file attribute } 

write('|')?; { separator to preceding field } 

if (DirBuf.Attribut and 1)<>0 then write('X') { Read-only? } 
else write(' '); 

if (DirBuf.Attribut and 2)<>0 then write('X') { hidden? } 
else write(" ‘); 

if (DirBuf.Attribut and 4)<>0 then write('X') { system? } 
else write(' ‘'); 

lf (DirBuf.Attribut and 8)<>0 then write('X') { Volume-Label? } 
else write(' '); 

if (DirBuf.Attribut and 16)<>0 then write('X') { Directory? } 

else write(' '); 
write (']*)> { right border of window frame } 
end; 


{ RRR EKKEK REE REE KKK KEKE KK HEKKE KEKE KK KEKE KKKKEKEKEKKEKKKKKEKKEKKEE } 


{* SETDTA : set Address of DTA =} 
{* Input : see above *} 
{* Output : none *} 


{ AHHH RAKHI KK KKK RIK KKK KKK KKK IK KEK KKK IKKE KKK KKK KEKE KKK AKER KEKE EE | 


procedure SetDTA (Segment, { new Segment address of the DTA } 
Offset : integer); { new Offset address of the DTA } 


var Register : regtyp; { Register-Variable for call of the Interrupt } 


begin 
Register.ax := S$1A shl 8; { Set Function number for DTA } 
Register.ds := Segment; { Segment address into DS register } 
Register.dx := Offset; { Offset address into DX register } 
msdos (Dos.Registers (Register) ); { Call DOS-Interrupt 21H } 
{NOTE: Turbo 3.0 users should change the previous} 
{line to read msdos (Register) ;} 
end; 


{ BERRA KAKAKRAKKEKKEKKEKREKRKRKKKKEKKKKEKKKEKKKKKEKKEKKKKEKKKKKKKKERKKKKKEKKEKKEKK | 


{* BUILDSCREENDISPLAY: prepares the display for output of the *} 
i Directory *} 
{* Input : none *} 
{* Output : none *} 


{ ER RR RRR RRR HERE RK KHER ERE KEK KERR KEKE KKK KK RRR KEK KEK KKK KKK KEKE KKKKEKKEKKKEKKE | 


procedure BuildScreenDisplay; 


var Counter : integer; 


begin 
clrscr; { clear display } 
window (14, (20-ENTRY) shr 1+1,64, (20-ENTRY) shr 1 +5+ENTRY); 
gotoxy (1,1); { Cursor to left upper corner of window } 
write (*/_——£—_—__p—__,-_—________,- ———__,—_]'); 
write('| Filename | Size | Date } Time }RHSVD|'); 
write (* |—————____+-———___ +} _—__ ++ I") 
for Counter := 1 to ENTRY do 
write('| | | | l')F 
write (*|———_—____-- |__| —___. } —-$ —_ |] —_-_]") ; 
window (15, (20-ENTRY) shr 1+4,66, (20-ENTRY) shr 1 +3+ENTRY); 
gotoxy (1, ENTRY); { Cursor to upper left corner of window } 
end; 


{ FERRE KEKE HARK KEKE KK KEKE KIKI KKK HA RKKKEKKEKKKKKEKKE | 


{* DIR: controls the input and output of Directories *} 
{* Input : none *} 
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{* Output : none et 
{RRR A ARERR RK KIRK RIK EK HRI KKK KKK KKK IKK IK EK KKK KKK KKK IKKE KE KKKKKKE | 


procedure Dir; 


var NumEntries, { Total number of entries found } 
Numwind : integer; { Number of entries in window } 
KeyPress : char; { wait for key activation } 
begin 
SetDTA (Seg (DirBuf), Ofs (DirBuf)); { DirBuf is the new DTA } 
clrscr; { clear display } 
writeln(*DIR (c) 1987 by Michael Tischer ' #13#10); 
writein, Please indicate search path for files ae 


writeln(‘Example: if all files with the extension .BAT in the root '); 
writeln('directory of the disk drive should be displayed please input '); 


writeln(' A:*.BAT.'); 

writeln(' If no search path is indicated, all files in the current'); 

writeln(‘ directory are displayed. '#13#10); 

write(‘Which files are to be displayed: '); 

readin (DatName) ; { read in filenames } 

if DatName = '' then DatName := '*,.*'; { search for all files } 

BuildScreenDisplay; { Construct display for output } 

Numwind := -1l; { no entry in window yet } 

NumEntries := 0; { no entry found } 

if GetFirst (DatName, 255) then { search for first entry } 
{ Attribute does not matter } 

repeat 

NumEntries := succ(NumEntries) ; { found another entry } 

Numwind := succ(Numwind); { one more entry into window } 

if Numwind = ENTRY then { window full ? } 

begin { Yes } 
window(14, (20-ENTRY) shr 1 +5+ENTRY, 66, (20-ENTRY) shr 1 +6+ENTRY); 
gotoxy(1, 1); { Cursor to last line of window } 
textbackground (7); { white background } 
textcolor (0); { black characters} 
write (' , Please press a key ae 
repeat until keypressed; { wait for key press } 
{read(kbd, KeyPress) ;} { read key code } 
{ otherwise it remains in the buffer } 
gotoxy(1, 1); { Cursor to the upper left corner of the window } 
text background (0); { black background } 
textcolor(15); { white characters } 
write(' a 
window(15, (20-ENTRY) shr 1+4,65, (20-ENTRY) shr 1 +3+ENTRY); 
gotoxy(1, ENTRY); { return Cursor to old position } 
Numwind := 0; { start count with O again } 
end; 

PrintData; { output data of entry } 
until not (GetNext); { does another entry exist ? } 
window(14, (20-ENTRY) shr 1 +5+ENTRY,65, (20-ENTRY) shr 1 +6+ENTRY); 
gotoxy(]1, 1); { Cursor to the upper left corner of window } 
textbackground (7); { white background } 
textcolor (0); { black characters } 
write (' a 


gotoxy (2, 1); 
case NumEntries of 
0 : write(‘no file found '); 
1 : write('found a file '); 
else write (NumEntries,' files found ') 
end; 
window({1, 1, 80, 25); { set whole display as window } 
end; 


{BARI RHR KIRK KR RRR IRI HII IIHR IHR RIK KIKI KR KKK KKK KAKAKREKKK KE 


ades MAIN PROGRAMM ed | 


{TARR RH KEK KK KER KKK KKH RK KKK KKK KKK IER KKK KEK KK HIKE KEKE KEREKKEKKKKKK KE) 


begin 
Dir; : { Load Directory and display } 
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end. 


PC System Programming 


In the above Pascal program and in the following C program, accessing the DTA 
is much easier than in the BASIC version of the same program. RECORD or 
STRUCT defines the structure of the directory entry into the DTA, and the 
programs implement a variable of this type. DOS function 1AH then transfers the 
DTA to this variable. All the information in a directory entry can be easily 
accessed. With Turbo Pascal, the display design is particularly easy. Turbo Pascal 
also has a procedure to define any display area as a window. However, the C 
language program uses the scroll function of the BIOS interrupt 10H to scroll the 
directory window one line upward. 


C listing: DIRC.C 
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[RRR KKK KKK KEK KKK KKK IKKE KHER KKK KKK KIRK KKK KRIKKKK KKK KKK KKK KKK / 


/* DIRC 

/* So! ‘me <2 cis‘ esis ls has a's is ene ea ww ce crs om cit cs men as mcm Ss ca i‘ scm em sso et nia in Se eb ls me ss ei seis ici Ss eis i! ea 
7 * Task : Displays all files in any Directory, 

/* including Sub-Directories and volume names 

/* on the screen. 

/* i sn sci cl St men’s soa ct im Se hn ene nin‘ ss his am Ss cn cms evi “cs em em mss“ ens “el ns Shs es pti ne Ss ee “sek cn shin es ‘nb Sn anim es a cm ed 
has Author : MICHAEL TISCHER 

i> developed on : 08/15/87 

is last Update : 04/08/89 

/* i as a ccs a a cl aN i a a wl cil cn ad a ae ene Sk as a ea om ee ee ee a ee ee a 
/* (MICROSOFT C) 

/* Creation : MSC DIRC; 

fs LINK DIRC; 

7* Call : DIRC 

/* Ss sich oa ei ems ems co Ses is wees iy avs ens” cos me es ema oe mls ec ny cas tess sme aks as ce Se om “cas css nen ec Sk eines es ee a i ew ams Ss isi ao ec 
/* (BORLAND TURBO C) 

/* Creation : With the RUN command in the command line 

/* Info Arguments can be passed to the program with 

is the OPTION/ARGS command in the command line 

/* of TURBO C 

/* or 

/* 

i Creation : TCC DIRC 

/*® Call : DIRC 


[BRAK ARK KKK KKK KEKE KEKE KKK IKK IIHR KAI KKK KK ERK KK KKK KKK KKK IKKE KEKE / 


#include <dos.h> 
#include <io.h> 
#include <string.h> 


#define 
#define 
#define 
#define 
#define 
#define 
#define 


FALSE 0 
TRUE 1 


/* include Header files 


/* Constants make reading of 
/* Program text easier 


byte unsigned char 
ENTRY 14 /* this many directory entries fit on the screen 


EZ (20-ENTRY >> 1) 


NRM 0x07 


/* first line of Directory window 
/* white characters on black background 


INV 0x70 /* black characters on white background (inverted) 


/*-- this is the format of a Directory entry returned by -------- 
/*-- the functions 4EH and 4FH 
struct DirStruct { 


byte 
byte 


Reservebuf [21]; 
Attribute; 


unsigned int Ftime; 
unsigned int Fdate; 
unsigned long Fsize; 


char 


}e 


Fname[13]; 


*/ 


oe 
“ff 


*/ 
ag 
a/ 
Rf 


*/ 
my 
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[RRR KR KEKE IK KARI KKK KIKI KHIR KKK IKKE KIKI IKK KIKI KKK IK KAI KKK KKK KK / 


/* GETPAGE : gets the current display page */ 
/* Input : none */ 
/* Output : see above */ 


[BRK KK AKI KRIKK KIKI ARAKI KIKI KK IKKE HAIR IK KAI HAAR IIK IKK K KKK AK KKK / 
byte GETPAGE () 


{ 
union REGS Register; /* Register-Variable for Interrupt call */ 


Register.h.ah = 15; /* Function number */ 
int86(UxLU, &kegister, &kegister); s* Caii Interrupt icin *, 
return (Register.h.bh) ; /* Number of current display */ 
} 


J RII IKI IIHR IK II II I TK IK IT I IK IIT II IKI IKI I THK II III IK IKI AIT KIKI AKAIKE AIK KA / 


/* SCROLLUP: moves a display area one or more lines xy 
/* upward or erases it */ 
/* Input : see above a 
/* Output : none a 
/* Info : if 0 is passed as number, the display area a 
f* is filled with blanks my 


[BRK RKIIRKRK KK KEKI KKK KR KR KRKKRKKKA KKK ERK RK KKK KKK K IKK KIRKE KKK RK KK KKK KEKE / 


void ScrollUp (Number, Color, ColumnUL, LineUL, ColumnLR, LineLR) 


int Number; /* Number of lines to be scrolled */ 
int Color; /* Color or attribute for blanks */ 
int ColumnUL; /* Column in the upper left corner of display area */ 
int LineUL; /* Line in the upper left corner of the display */ 
int ColumnLR;/* Column in the lower right corner of the display area */ 
int LineLR; /* Line in the lower right corner of the display area */ 
{ 

union REGS Register; /* Register-Variable for Interrupt call */ 


/* Function number */ 
/* Number of lines */ 


Register.h.ah = 6; 
Register.h.al = Number; 
Register.h.bh = Color; /* Color of blank line(s) */ 
Register.h.ch = LineUL; /* Coordinates of the scroll */ 
Register.h.cl = ColumnuUL; /* end or erase */ 
Register.h.dh = LineLR; /* Set display window */ 
Register.h.dl = ColumnLR; 
int86(0x10, &Register, &Register); 
} 


/* Call Interrupt 10H */ 


[BERK KEIRIKKKKEIKKEKKKKKRRKKIKKKKKEKKKKRKEKKE KEKE KKK KKK ERK KKK KKK KKK KKK / 


/* SETPOS : sets the position of the cursor in current display page */ 
/* Input : see above */ 
/* Output : none i d 
/* Info : the position of the blinking display cursor is changed */ 
i* by the call of this function only when the */ 
[> display page indicated is the current display page x] 
ia “7 


[RRR KERRIER IKK KI KKK KKK KIRK AK KKK IKK KKK IK AIK IK IKK IKK KKK KKK KKKKIK KEKE K EK / 


void SetPos(Column, Line) 


int Column; /* new Cursor column */ 
int Line; /* new Cursor line */ 
{ 

union REGS Register; /* Register-Variable for Interrupt call */ 


Register .h.ah = 2; /* Function number */ 


Register.h.bh = GETPAGE(); /* Display page */ 
Register.h.dh = Line; /* Display line */ 
Register.h.dl = Column; /* Display column */ 


int86(0x10, &Register, &Register); /* Call Interrupt 10H */ 
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J RRR KKK KEK KEK IKK KKK KIER RHR KIRKE KKK KKK ERK IKKE KKK KEK KEKE KEK EEK KE / 


/* GETPOS : Get the position of the Cursor in current display page */ 
/* Input : none */ 
/* Output : see below ny 


[BRK K KKK EK KKEKE KKK IKE KER KEKE KEK AK KK KKK KKK KEK KKK KEKE KEKE KKK KKK KEKKKE / 


void GetPos(Column, Line) 


int *Column; /* Column where the Cursor is located */ 
int *Line; /* Line where the Cursor is located */ 
{ 

union REGS Register; /* Register-Variable for Interrupt call */ 
Register.h.ah = 3; /* Function number */ 
Register.h.bh = GETPAGE (); /* Display page */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10H */ 
*Column = Register.h.dl; /* Read result of the Function */ 
*Line = Register.h.dh; /* from the Registers */ 


} 


[RRR RK KKK KKK KK IK KEK KEKE KEK KEKE KK KEE KEKE KEKE KE KEKE EEK KK KKEKKKKKKEKK / 


/* WRITECHAR: writes a character with an attribute to the current */ 


Es cursor position on the current display page */ 
/* Input : see below */ 
/* Output : none ay. 


[RRR KEK KEK KAR KIER KKK IKE KKK KAKI KIER KEK KKK KEK KKK EK KEKE KEK KEK KEKE KKKKEKEE / 


void WriteChar (Character, Color) 


char Character; /* Character for output */ 
int Color; /* its Attribute or color */ 
{ 

union REGS Register; /* Register-Variable for Interrupt call */ 
Register.h.ah = 9; /* Function number */ 
Register.h.al = Character; /* character for output */ 
Register.h.bh = GETPAGE (); /* Display page */ 
Register.h.bl = Color; /* Color of character for output */ 
Register.x.cx = 1; /* output character only once */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10H */ 


} 


[RRR KKK RK IKK KKK KKK KER KEK KKK KEKE KEK KA KKK KKK KK KKK KKK EKKKKEKK KK KKK KK / 


/* WT : writes a character string with constant color starting */ 
/* at a specified position on the current display page. */ 
/* Input : see below x / 
/* Output <: none a7 
/* Info : Text is a Pointer to a character Vector, which contains */ 
/* the text to be output and is terminated with a ‘\0' “7 
{* character, a 


[L RRKKEKKKKKKK KAR KIKI IKK HAKKAR AKI KKK KAKA KAKKEKKAKKKKEKKEKK KKK KKK / 


void WT (Column, Line, Text, Color} 


int Column; /* Display column for output */ 
int Line; /* Display line for output */ 
char *Text; /* Text for output */ 
int Color; /* Color/Attribute of the Text */ 
{ 
union REGS Register; /* Register-Variable for Interrupt call */ 
SetPos (Column, Line); /* Set Cursor */ 
while (*Text) /* Output Text up to ‘\0' character */ 
{ 
WriteChar(' ‘, Color); /* Indicate color */ 
Register.h.ah = 14; /* Function number */ 
Register.h.bh = GETPAGE(); /* Display page */ 
Register.h.al = *Text++; /* of character to be output */ 
int86(0x10, &Register, &Register); /* Call Interrupt */ 
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} 


[RRR K IKK KKK KEKE KEKE KEKE ERK KEK KEKE EKEK / 


/* CLS : Clear current display and set Cursor into upper left a7. 
/* corner */ 
/* Input : none */ 
/* Output : none x/ 


[RIKI ITI IKI IK ITI HII KK KIKI IKI KK KIKI KI KKK KIRK KKK KI KKK KAKA KEKE / 


void Cls() 

{ 

Scroilup(0, NRM, 0, 6, 73, Z4); ph Giese Seceen 47 
SetPos(0, 0); /* Set Cursor */ 


} 


[RII KKK II KKK IKK IK IKK KIKI KKK KIKI KI KR IKK KK IKK KKK IK KKK ERE KIRK IK EK / 


/* BUILDSCREENDISPLAY: prepares the display for the output of the x]. 


/* Directory. */ 
/* Input : none a 
/* Output : none */ 


[RIKKI IK KIKI KKK IK KIKI II KAI IKK III KIKI KKK IKKE KKK AK KEK KKK / 
void BuildScreenDisplay () 


{ 


byte i; /* Loop Counter */ 
Cls(); /* Clear Screen */ 
WI(14,E2, 00 “{———$— fp fp - >", NoF) ; 
WI (14,EZ+1,"| Filename | Size | Date | Time  |RHSVD|",NOF); 
WT (14, E2+2, °|——————+—__+#______ ++ |", NOF) ; 
for (i = EZ+3; i < EZ+3+ENTRY; i++) 
WT (14,1, “| | | | | |",NOF) ; 
WT (14, EZ+ENTRY+3, ¢{|———————— 1. ——_ 1 —__________- icemenee oat ? 
NOF) ; 


} 


[RRR KKK KKK KKK IKK KKK KKK KKK KKK KKK IKK KK KEK KEKE KKK KKK KKEKEKKEKKEK / 


/* PRINTDATA: Output information about an entry at 
/* Input : see below */ 
/* Output > none Be 


[RRR KKK KKK IKK KK IEKIKKKKKK RK KIK IKKE IKKE KEK IK / 


void PrintData(DirEntry, Line) 


struct DirStruct *DirEntry; /* a Directory entry */ 
byte Line; /* Display line of entry */ 
{ 

byte i; /* Loop Counter */ 
static char *Month[] = /* Vector with Pointer to name of month */ 


{ 
ity JAN a - "FEB" ; "MAR" ; "AP R" ; “MAY "* ; iT] JUN te j 
ae JUL" 7 *“AUG" r ity SEP it} ; "OCT" 7 "NOV" ; “DEC Lt 
}; 


SetPos (15, Line); /* Set Cursor position for file name */ 
for (i=0; (*DirEntry).Fname[i] && i<15 ; printf ("%c", (*DirEntry) .Fname[i++])) 


¢ 


SetPos (28, Line); /* Set Cursor position for file size */ 
printf ("$7lu", (*DirEntry) .Fsize); /* Output file size */ 
SetPos (36, Line); /* Set Cursor position for Date */ 


printf ("“%s-%2d-%4d", Month[{((*DirEntry).Fdate >> 5 & 15) - 1}, 
(*DirEntry).Fdate & 31, ((*DirEntry).Fdate >> 9) + 1980); 


SetPos (49, Line); /* Set Cursor position for Time */ 
printf ("$2d:%2d", (*DirEntry) .Ftime >> 11, (*DirEntry).Ftime >> 5 & 63); 
SetPos (59, Line); /* Set Cursor position for Attribute */ 


for (1 = 17; 1 <= 16; i <<= 1) 
if ((*DirEntry) Attribute « i) printf ("X")}; 
else printf(" "); 
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} 


[RRR KKK KKK KKK KIKI KEKE KK KEK KKK KEK KEK KKK KEK KKK KKK KKK KK EKEKEKEKKEKKKHK / 


/* GETNEXT : read the following Directory entry */ 
/* Input : none */ 
/* Output : TRUE, when an entry was found, otherwise FALSE ay 
/* Info : the entry is read into DTA rem */ 


[RRR IKK IKK IKKE IERIE HII KKK KKK HAKKAR KIKI AK KIKI KKK KKK IKKE KKK AKKK | 
byte GetNext () 


{ ; 
union REGS Register; /* Register-Variable for Interrupt call */ 


Register.h.ah = O0x4F; /* Function number for Search of next entry */ 
intdos (&Register, &Register); /* Call DOS-Intr. 21H */ 
return (!Register.x.cflag); /* Carry~-Flag = 0: file found */ 
} 


JRA KIRA I IK IK RII IIR ITT IT RIKI TOK TOIT IT IKI AIA I KIKI KARA AAI IA KAA AAA AKA KAKA K / 


/* GETFIRST : read the first Directory entry x7, 
/* Input : none df 
/* Output : TRUE, if entry was found, otherwise FALSE a7 
/* Info : Entry is read into the DTA a 


[RRR KEKE KK KIRKE IRE KEKE RE KEK KIRKE KKK KE KEKE KEKE KR KEK KEKE EKKEKKEE / 


byte GetFirst (Sname, Attribute) 


char *Sname; /* file to be found */ 
unsigned int Attribute; /* the Search Attribute */ 
{ 
union REGS Register; /* Register-Variable for Interrupt call */ 
struct SREGS Segmente; /* accepts Segment register */ 
segread (&Segmente) ; /* Read in content of Segment register */ 
Register.h.ah = 0x4E; /* Function number for search of first */ 


Register.x.cx = Attribute; /* Attribute, for which search is made */ 
Register.x.dx = (unsigned int) Sname; /* Offset address search path*/ 
intdosx(&Register, &Register, &Segmente); /* Call DOS-Intr. 21H */ 
return (!Register.x.cflag); /* Carry-Flag = 0: file found */ 
} 


[RRR KIKI KKK KKK KKK KIKI IKK KEK KKK IKK IKKE KEKE K KEK KEK KKK KREKKHKKEKK KE / 


/* SETDTA : sets the DTA to a Variable in the Data Segment «/ 
/* Input : see below */ 
/* Output : none * f 


[RRR EKER KKK KK KKK KEK KEK KKK KKK KKK KKK KKK KKK KEKE KKK KKK EKKEK KKK KEK KKKKE / 


void SetDTA (Offset) 


unsigned int Offset; /* new Offset address of the DTA */ 
{ 

union REGS Register; /* Register-Variable for Interrupt call */ 
struct SREGS Segment; /* accepts the Segment register */ 
segread (&Segment) ; /* Read in content of Segment register */ 
Register.h.ah = OxlA; /* Set Function number for DTA */ 
Register.x.dx = Offset; /* Offset address into DX-Register */ 
intdosx(&Register, &Register, &Segment); /* Call DOS-Intr. 21H */ 


} 


JL RRREKAKKR EKER KKK KKK KKK KEK IKI KKK RIKKI KEKE IKKE KAA KKHKKKEKKEKKKKKKK / 


/* DIR : controls the input and output of Directories */. 
/* Input : see below af 
/* Output : none as 


[BERR RKRKKK KKK KEKE RK KK KK KIKI KEKE KIRK IAK KEKE KKK K AK KKK KEKE KIRA KEKKEKKE KK / 


void Dir(Sname, Attribute) 
char *Sname; /* Pointer to Character Vector, containing search path */ 
int Attribute; /* Attribute of file to be found */ 
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int NumEntries, 
Numwind; 
struct DirStruct DirEntry; 


SetDTA (&DirEntry) ; 


/* Total number of entries found 
/* Number of entries in display 
/* a Directory entry 


/* DIRENTRY is the new DTA 


BuildScreenDisplay(}; /* Construct display for new Directory output 


Numwind = NumEntries = 0; /* no entry displayed in the window 


if (GetFirst (Sname, Attribute) ) 
f 


4 


do 
{ 


PrintData(&DirEntry, EZ+ENTRY+2) ; 


if (++Numwind == ENTRY ) 
{ 


Numwind = 0> 
WI(14, EZ+4+ENTRY, 
a 


getch (}; 
WT (14, EZ+4+ENTRY, 
wu 


} 


ScrollUp(1, NRM, 15, EZ+3, 63, EZ+2+ENTRY) ; 


WT (15, EZ+2+ENTRY, 
++NumEntries; | , 
shits (GetNext ())7 
eeeeie, EZ+4+ENTRY) 3: 
switch (NumEntries) 


{ 


ease 0 : printf("no files found "); 


break; 


case 1 : printf("“one file found "); 


break; 


default : printf ("%d files found ", NumEntries) ; 


} 
} 


Please press a key 


/* no entry found 


/* search for first entry 


/* output entry 
/* Window full ? 


/* fill a window 


ae INV) H 
/* wait for key 


wo NRM) - 


" NOF); 


ay 
*/ 
a 


*/ 
*/ 


x} 


ay, 
*/ 


Lf 
*/ 


aT | 


*/ 


[RR RK KK IIHR IKK RII KKK KIKI II KK IKKE KK KIRKE KEK IK KKK EKER KKKKKEKEK / 


ax / 


[RRR KKK IK IKI KK IK KK KK KK KKK KKK RK KKK KEKE KEK KEK KKK KEK KK KKK KKK KK / 


fer MAIN PROGRAM 


void main(Number, Argument) 
int Number; 
char *Argument[]; 
{ 
switch (Number) 
{ 
case 1 : Dir("*.*", ~0); 
break; 


/ 
/* Number of Arguments + 1 passed 
/* Vector with pointer to Arguments 


/* react according to 


/* Arguments passed 
/* Display all files in current 


/* Directory 


case 2 : Dir(Argument[1], ~0); /* Display all files in indicated 


break; 


/* Directory 


default : printf ("Invalid number of Parameters\n"); 


} 
} 


7. 
*/ 


a 
*/ 
a} 
*] 
af 
*/ 
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6.8 The EXEC Function 


The EXEC function has been mentioned briefly several times before in relation to 
the command processor. We’ll examine the EXEC function more fully here and 
describe its operation. | 


Parent/child 


The EXEC function is one of the many DOS functions which can be called with 
interrupt 21H (function 4BH). Generally speaking, this function lets a parent 
program (main program) call a child program (secondary program). The child 
program is loaded from a mass storage device into memory and then executes. If 
this child program doesn’t become resident, the memory occupied by the child is 
released following program execution. The child program can also call another 
program which works with the parent program. This creates a type of program 
chaining limited only by the amount of available RAM. 


One example of the EXEC function is the command processor. Using the EXEC 
function, the command processor executes user-specified programs and becomes the 
parent program. Some programs (such as Microsoft Word®) permit the user to 
execute DOS commands from the main program using this function. 


The parent program can pass parameters to the child program in the command line 
and can also pass parameters using the environment block. It can also transfer 
information to the child program within the PSP. Since the child program, like all 
executable programs, has a PSP preceding it, information can be entered into the 
two FCBs within this PSP and made accessible to the child program. 


Child program 
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After transferring control to the child program, it can access all files and devices 
previously opened by the parent program (or one of the parent programs) with a 
handle function. This allows the child program to read information from a file or 
write information to a file whose handle is known (the child program doesn’t need 
to know the filename). This is only possible if the handle was passed by the parent 
program in one of the three methods described, or if the child program refers to one 
of the five handles which are always open. These file accesses affect the file 
pointer. Since values are not reset, these file accesses become “visible” to the 
parent program when control returns to the parent program. 


After execution of the child program, control returns to the parent program and 
execution continues. To pass information (e.g., an error that occurred during the 
execution of the child program), the child program can pass a numeric value at the 
end of its execution. This can be done using DOS function 4CH, which terminates 
a program and returns a code to the parent program. 


The communication between parent and child program functions only if both 
programs agree on this return value. After control returns to the parent program, it 
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can determine the code using function 4DH of interrupt 21H. To use function 4DH 
only the function number is passed in the AH register. The code passed by the 
child program is returned to the calling (parent) program in the AL register. 


Ending the child program 


EXEC 


In addition, the contents of the AH register indicate how the child program 
terminated. The value 0 indicates a normal termination, while 1 shows that the 
child program terminated when the user pressed <Control><C> or 
<Control><Break>. If an error during access to a mass storage device forced the 
child program to terminate, a code of 2 is passed in the AH register. Finally the 
value 3 indicates that the child program terminated from a call to function 31H, or 
interrupt 27H; the child program then becomes resident in memory. 


As mentioned previously, the EXEC function can only load the child program if 
enough memory is available. While DOS can estimate the memory needed for 
EXE programs fairly accurately, it cannot do the same for COM programs. For 
COM programs DOS reserves all unused memory. Because of this, a COM 
program cannot call another program with the EXEC function, since DOS reserves 
no extra memory. The same is true for many EXE programs. If a call to a child 
program is necessary, the required memory space must be released from the calling 
program before calling the EXEC function (see Sections 6.4.1 and 6.4.2 for 
explanations on how this is done). 


If the EXEC function is called, the various parameters are loaded into the registers 
before calling interrupt 21H. Function number 4BH is passed in the AH register. 
A value of 0 or 3 is passed in the AL register. A value of 0 indicates that the 
EXEC function is to load and execute the program while a value of 3 indicates that 
the program is loaded as an overlay (without executing it). The address of the name 
of the program to be loaded or executed is passed in the DS:DX register pair. And 
the address of the parameter block is passed in the ES:BX register pair. 


The program name is specified as an ASCII string and ended with a null character 
(ASCII code 0). The program name can include the device name and a complete 
path description. Its last element is the program name which, besides the name 
itself, must have the extension .COM or .EXE. If the device name or path 
designation are omitted, the system searches for the program in the current 
directory of the current device. Since the EXEC function cannot execute a batch 
file directly, the program name passed cannot contain the extension .BAT. 


Batch child 


If a batch file is to be executed, the COMMAND.COM (command processor) file 
must be invoked first. To indicate that a batch file should be executed, the 
parameter /c followed by the name of the batch file to be executed is included on 
the command line. Besides the ability to execute a batch file, calling the command 
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processor with the /c parameter offers the option of calling any other program, and 
even internal DOS commands such as DIR. 


Besides calling a program directly, it’s possible to specify program names without 
file extensions during a command processor call. The command processor searches 
for an EXE file; then a COM file; and finally a BAT file. If none of these files 
exist in the current directory, it searches all directories specified in the PATH 
command. This chain of events is not followed during a direct program call 
without the addition of the command processor. 


The directory which contains the command processor should be specified. If not 
specified, it will be loaded from the path indicated by the COMSPEC environment 
string of the SET command. 


Parameter blocks 


Parameters can be passed to the command processor in the parameter block 
following the program name. These parameters are identical to the parameters 
entered from the keyboard when the program is called. How these parameters affect 
the EXEC function will be seen shortly, but first take a look at the parameter 
block’s structure when the AL register contains the value 0. This block’s address is 
passed to the EXEC function in the register pair ES:BX. 


[4-5 __| Segment_address of the command parameter 
[8-9 _| Segment _address of the first FCB 
[6__} 10-11 _] Offset_address of the second FCB 
3 


i 
bt 
PP 
ae Det 
Wit 


Field 1 indicates the segment address of the child program’s environment block. 
This block doesn’t require an offset address since it always starts at a location 
divisible by 16, and therefore its offset address is always to 0. 


Environment block 
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The command processor and other programs obtain information from the 
environment block. The environment block is a series of ASCII character strings. 
This information can include paths for file searches. Each string has the following 
syntax, terminated by a null character (ASCII code 0): 


Name = Parameter 


The individual strings follow each other sequentially (i.e., the null character of one 
string 1s immediately followed by the beginning character of the next string). The 
environment block ends with a null character. Any environment block has a 
maximum length of 32K. 
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The environment block can be changed or modified by the user using the DOS 
SET and PATH commands. Programs which remain resident after execution are 
unaffected by any changes made to the environment block through these two DOS 
commands once made resident. 


If the parent program wants to pass information to the child program using the 
environment block, it can either construct a new environment block or supplement 
its Own environment block with this information. In the first case, the segment 
address of the new environment block is specified in the first field of the parameter 
block. If the child program should have access to the environment block of the 
parent program, specify a value of 0 in this field. Before turning over control to 
the child program, the EXEC function stores the segment address of the 
environment block in the memory location at address 2CH of the child program's 
PSP. 


If the child program is to use a new environment block, it should contain at least 3 
strings which are normally part of the environment block of the parent program, 
and are important to the command processor: 

COMSPEC = Parameter 


PATH = Parameter 
PROMPT = Parameter 


If a child program modifies its environment block, the parent program’s 
environment block remains unchanged after the child program completes its 
execution. 


Fields 2 and 3 indicate the command parameters’ address which is passed to the 
PSP of the program starting at address 80H. They must have the same structure in 
memory as expected by DOS in the PSP. The first byte indicates the number of 
command characters minus 1, then follows the command characters as normal 
ASCII codes. The command parameters terminate with a carriage return (ASCII 
code 13) which is not included in the character count. The first character in the 
string should be a space for compatibility with COMMAND.COM. 


To call a batch program (called DO.BAT) using the command processor, the 
following command parameters must be specified as a string in memory: 


DB 10," /C DO.BAT",13 


The EXEC function copies the command parameters in a controlled fashion into 
the PSP of the program to be executed. It removes all parameters which would 
redirect the input or output, since a redirection of the standard input/output can 
only be performed by the parent program. The child program can still use 
input/output redirection if the standard input/output handles have been redirected by 
the parent program (see Section 6.10 for more detailed information and an example 
of this process). 
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Fields 6, 7, 10 and 11 indicate two FCBs installed in the PSP at address 5CH or 
6CH. If this is not required, specify -1 (FFFFH) in these two fields. If program 
execution requires it, enter the first two command parameters in the two FCBs 
with DOS function 29H. Before passing control to the child program, the EXEC 
function copies these two FCBs into the PSP of the child program. 


Even though all registers and the parameter block now have the required values, the 
EXEC function cannot be called yet. Since it destroys the contents of all registers 
up to the CS and IP registers during execution, the contents of all registers must 
be placed on the stack before it is invoked. Then the contents of the SS and SP 
registers must be stored within the code segment. Only then can interrupt 21H 
function 4BH be called to activate the EXEC function. After the EXEC function 
ends, the carry flag signals if the function executed normally. Before program 
execution can continue, the value of the SS and SP registers must be restored, 
from the code segment. Then the contents of the other register can be restored 
again from the stack. 


The EXEC function serves a different purpose when a value of 3 appears in the AL 
register. In this case, it loads a COM program or an EXE program into memory 
without executing. After the target program is loaded, control immediately returns 
to the calling program. In contrast with sub-function 0, the program loads to a 
memory address indicated by the calling program instead of loading to any non- 
specific location. Since no parameters are passed to the loaded program, the 
parameter block has a different structure during the call of sub-function 3 than 
during the call of sub-function 0: 


EEE: SRR ES 
a Co Segment address where overlay is loaded 
2 ff 2-3 | | Relocation factor 


Before the function is called, the segment address to which the program should be 
loaded is specified in the first field of the parameter block. If the calling program 
doesn’t have enough memory available for loading the external program, it should 
request additional memory with one of the DOS memory management functions. 
The loaded program loads directly to the segment address indicated with the offset 
address 0 since no PSP precedes the program. 


Relocation 
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The relocation factor adjusts the segment address of the called program. Since this 
factor applies only to EXE programs (COM programs cannot have specific 
segment assignments), the relocation factor for COM programs should always be 
equal to 0. The relocation factor for EXE programs should indicate the segment 
address where the program will be loaded to confirm to the program’s segment 
assignments. 


After the program is loaded, its routines are ready to be accessed. The routines of 
the loaded program should always be treated as subroutines; and therefore, called 
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with the machine language CALL instruction. It must always be a FAR type 
instruction even though the loaded program may be located immediately following 
the calling program, but can never have the same segment address. The offset 
address for CALL is always 100H for a COM program, since execution always 
starts immediately following the PSP at address 100H. This creates a problem. 
Sub-function 3 prevents the PSP from loading. Therefore the code segment of the 
COM program starts at address 0, not at the offset address 100H (relative to the 
load segment). Since all jump instructions and accesses to data within the COM 
program are relative to address i00H and not address 0, you cannot execute a FAR 
CALL instruction with the address of the load segment as the segment address, and 
address 0 as the offset address. The segment address for the FAR CALL must 
indicate the address of the load segment minus 10H and the address 100H as the 
offset address. 


If the COM program specifically acts as an overlay for another program, entry 
addresses other than address 100H are possible. In such a case, only the offset 
address for the FAR CALL instruction changes. The segment address must remain 
10H smaller than the address of the load segment. 


EXEC and memory 


The problem is different for EXE programs. If they are loaded for execution using 
sub-function 0, the EXEC function sets the code segment and the instruction 
pointer to the instruction which was declared as the first instruction in the 
assembler source. This address, however, is unknown to the program which loaded 
the EXE program as an overlay. This can easily be remedied by placing the first 
executable instruction in the EXE program at the beginning of the EXE program. 
This makes its offset address 0. The EXE program source must not be in the 
normal sequence with the stack first. In this case, the code segment must be the 
first segment in the source to ensure that it begins the EXE program. 


The FAR CALL uses the address of the load segment as the segment address, and 
address 0 as the offset address. 


While BASIC, Pascal and C have commands or procedures to call a program from 
another program, assembly language routines must use DOS function 4BH. To 
help you further understand this function, here is an example program. 


The framework of the EXE program listed in Section 6.4.2 acts as the basis for 
this program. The EXEPRG procedure performs the actual dirty work in this 
program. It calls the new program using function 4BH. Two strings which contain 
the name of the program to be called and the necessary parameters are passed to it. 
Both strings end with the null character (ASCII code 0). All variables required by 
EXEPRG for execution can be found in the code segment. This offers the 
advantage that the lines from the code segment only must be copied into one of the 
application programs to use this routine. After calling EXEPRG, the carry flag 
signals if an error occurred. If true (carry flag=1), the AX register contains the error 
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code as returned by the EXEC function of DOS. If the called program executed 
correctly, the carry flag is reset (0) and the termination code of the called program, 
as returned by DOS function 4DH, is returned by the AX register. 


Within this program, EXEPRG displays the current directory using the command 
processor. The command processor defaults to the current directory of the current 
device. 


FERRARA RK ARERR RERKR KERR KR RRR RKE RK HAKK KERR EKER HAKKAR K AK KEKEKKERKKEKREE 9 
lia EXEC *; 
ox ‘i sn cn sis sn ci ein Sm iis ric Sn ie i coma oe i ni es miu as i Cams tes ae cain cscs imi aa es ec ces ne sas suo ‘cass caer seston asa cs te nb ld its ves es 
:* Task : Calls a program with the help of the ge 
7* EXEC function of DOS. In this example Ps 
aed program the content of the current bal 
ne Directory of the current device is displayed. *; 
OI a a as ik le es ee wes ee ee co eo ses es es et es a ad ese ee oe os SS ae ee ee es ee ee a me Ge ws Ga Se ee ee es ew ke 
v cf 
td Author : MICHAEL TISCHER +7 
3% developed on : 08/01/87 * 
- last Update : 04/08/89 * 
os sc ce ins t's ei i ei i es tb ih a ur ness ini sts i'n sea unc neni cin em sn ‘aa ss is eos esses tps ck tes emus es wes nis ‘anin la hb tw Gar es ns x» 
7* assembly : MASM EXEC; *; 
7* LINK EXEC; "; 
oe iss" a pins ibe cin’ > un tub i ees “as ess > as lis ame mea an Casson ems cab Ysa Sd cane caw a ees Gn cs ks cu Ca wk nn sem‘ mas “ncn Sen un GOD in a a Sat Si Se sn tue aS i air) 
ed Call : EXEC *; 
FERRER KKK EERE KEKE EER ERK RK ERK KEK KKK EEK KKK KK KKK KKKEEKKKEEKKKKKKKKEKKKE 9 


data segment para ‘DATA' ;Definition of the data-segment 
prgname db “\command.com", 0 7;Name of the program to be called 
prgpara db “/c dir",0 7;Parameters passed to program 
data ends 7;end of data-segment 
code segment para 'CODE' 7;Definition of the CODE-segment 
assume cs:code, ds:data, ss:stack 
exec proc far 
mov ax,data ;Load segment address of the data segment 
mov ds,ax zinto the DS-register 
call setfree ;release unused memory 
mov dx,offset prgname ;offset address of program name 
mov si,offset prgpara j;offset address of command line 
call exeprg 7Call program 
mov ax,4C00h ; zend program with call of a DOS function 
int 21h yon return of error-code 0 
exec endp 


SETFREE: Release memory not used ---------------- 


-- Input : ES = address of PSP 

-- Output : none 

-~ Register : AX, BX, CL and FLAGS are changed 

-- Info : Since the stack-segment is always the last segment in an 


EXE-file, ES:0000 points to the beginning and SS:SP 
to the end of the program in memory. Through this the 
length of the program can be calculated 


“ses se Se Ne VWs VWs Be Ve 


set free proc near 
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mov bx,ss ;first subtract the two segment addresses 
mov ax,es ;from each other. The result is 
sub bx,ax ;number of paragraphs from PSP 
zto the beginning of the stack 
mov ax,sp ;since the stackpointer is at the end of 
mov cl,4 7the stack segment, its content indicates 
shr ax,cl zthe length of the stack 
add bx,ax zadd to current length 
inc bx sas precaution add another paragraph 
mov’ ah, 4ah ;pass new length to DOS 
int 21h 
ret z;back to caller 


set free endp 


~~ EXEPRG: call another program 3~--------<--------------------- 
Input : DS:DX = address of the Program Name 
-- DS:SI = address of the Command Line 


“ae “se Te Ne Ve Ne Ve 


-- Output : carry flag = 1: Error (AX = Error-code) 

~- Register : only AX and FLAGS are changed 

-- Info : Program name and Command Line must be ASCII-String 
-— and terminated with ASCII-code 0 
exeprg proc near 


;Transmit Command Line into own buffer -- 
yand count characters == 


push bx 7;Store all registers which are 
push cx ;destroyed by the call to the 
push dx 7;DOS EXEC function 

push di 

push si 

push bp 

push ds 

push es 


mov di,offset comline+l ;address of chars in Command Line. 


push cs 7CS to stack 
pop es 7back as ES 
xor bl,bl 7;Set character count to 0 
copypara: lodsb ;read a character 
or al,al zis it a NUL-code (end) 
je copyend 7Yes ~-> copied enough 
stosb ;store in new buffer 
ine. pi. yincrement character count 
cmp bl1,126 ;Maximum reached? 
jne copypara 7;No --> continue 
copyend: mov cs:comline,bl 7store number of characters 


mov byte ptr es:[(diJ],13 ;finish command line 


mov cs:merkss,Sss 7SS and SP must be stored in 
mov cs:merksp, sp ;variables in code segment 


mov bx,offset parblock ;ES:BX points to parameter block 


mov ax, 4BO0Oh ;function number for EXEC function 
int 2ih 7Call DOS-function 

cli 7;Set interrupts for a moment from 
mov sSs,cs:merkss ;stack segment and stackpointer to 
mov sp,cs:merksp ;their old values 

sti ;Switch interrupt on again 

pop es 7Get all Registers from stack again 
pop ds 

pop bp 
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pop si 

pop di 

pop dx 
pop cx 
pop bx 

je  exeend 
mov ah, 4dh 
int 21h 


exeend: ret 


PC System Programming 


;Errors? YES --> end 
sno errors, sense end-code of the 
;program which was executed 


p;boack to caller 


~~ Variables of this routine only addressable through CS -- 


merkss dw (?) saccepts SS during program call 
merksp dw (?) zaccepts SP during program call 
parblock equ this word 7;Parameter block for EXEC function 
dw 0 zenvironment block 
dw offset comline ;offset and segment address of 
dw seg code ;modified Command Line 
dd 0 j;no data in PSP #1 
dd 0 sno data in PSP #2 
comline db 128 dup (?) yaccepts modified Command Line 
exeprg endp 
stack segment para stack ;Definition of the stack-segment 
dw 256 dup (?) zthe stack has 256 Words 
stack ends 7End of the stack-segment 
code ends 7End of the CODE-segment 


end exec 


;for execution start with EXEC 
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Memory Allocation from DOS 


DOS subdivides the maximum 640K of memory into roughly two areas. The first 
area is designated as the operating system area. It begins at memory location 
0000:0000 and contains the interrupt vector table, some internal tables, buffers, 
variable memory and the operating system code. This code retains the resident 
portion of the command processor and the resident and installable device drivers. 
The size of this area varies with the version of DOS in use, the sizes of the device 
drivers installed, and other factors such as the number of disk buffers available. 


The second area is designated as the JPA (Transient Program Area). It contains 
programs and their environment blocks for execution. The TPA starts after the end 
of the operating system area. Depending on the memory requirements of the 
individual programs, DOS assigns them different amounts of memory administered 
through a special data block preceding every memory range and connected with the 
data block of the next memory range. This also applies to memory not assigned to 


a program. 


This data block, called a memory control block (or MCB) is a 16-byte block 
containing a variety of information. An MCB begins at one of the addresses 
divisible by 16, and controls memory allocation. DOS looks for the segment 
address of the allocated memory range, and is helped in this task through the MCB. 
The following table shows the structure of an MCB in memory: 


Contents [Type 


Allocated memory range |x paragraphs | 


As the table above illustrates, the MCB contains three fields. The first field 
indicates whether any MCBs follow the current MCB under analysis. The letters 
"M" (more MCBs to follow) and "Z" (last MCB) are the initials of one of the 
creators of MS-DOS, Mark Zbikowski. 


The second field specifies the segment address of the corresponding program's PSP. 
This only applies when memory allocation becomes a part of the environment of 
the program being handled, in which case the PSP is indicated by the contents of 
this field. In most cases, this field simply points to the memory range needed by 
the program. 


The third field of the MCB specifies the size of the corresponding memory range in 
paragraphs. Next follows the memory range itself, then any further MCBs after 
that (provided that the first field contains an "M" ID letter). MCBs can be linked 
together to create a group, as shown in the figure below: 
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Start of memory— ~~ ~~~ ~~ —~<‘<—~‘ 


(0000:0000) 
Start of TPA 


Controlled by Memory Control Block 1 


Memory Control Block 2 ~ 


Controlled by Memory Control Block 2 


Memory Control Block 3 
Controlled by Memory Control Block 3 


Memory Control Block 4 (last MCB) 


'Controlled by Memory Control Block 4 


End of TPA 
End of memory 


Memory allocation 


If the DOS EXEC loader loads and executes a program, this function immediately 
requests two data areas through another DOS function. The first of these two areas 
stores the environment block, while the second accepts the current program and the 
program's PSP. The size of the area made available to a program is difficult to 
estimate from the EXEC loader. This is even more difficult for COM programs 
than for EXE programs since COM programs are copies of memory contents and 
have no information preceding them. DOS therefore defaults to the maximum and 
reserves the total available memory for a COM program. 


This method worked well in the early days of DOS, but has created other 
problems. While only one program could exist in memory at a time in the early 
days of DOS, now it’s common for one program to load and run a second program, 
or even make one of the programs permanently resident in memory. This can’t be 
done if no memory exists, as would be the case after loading a COM program. 
This is why a COM program should always release the memory it no longer needs 
after it starts (see Section 6.4.1 for details on how this happens). 


A COM program can only load when a memory range large enough to 
accommodate the COM program exists (plus 256 bytes for the PSP and at least 2 
bytes for the stack). The COM program ensures that enough memory is available. 
Under the minimum conditions presented above, the program probably won’t run 
without errors, since few programs can operate with only a 2-byte stack. 


EXE program files have a set of information created by the linker. The EXEC 
loader can determine the amount of memory required for code segment, data and 
stack from this information. The start of the EXE program itself contains 
additional information about the amount of memory needed for the program. This 
amount defines an upper and lower limit of the additional memory, rather than a 
specific number of bytes. The EXEC loader tries to reserve the upper limit of 
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memory if it can. If this is not possible, the EXEC loader uses the lower limit or 
reserves the remainder of memory. If the lower limit of memory cannot be 
allocated, the loading process aborts and control returns to the program which 
called the EXEC loader (in most cases, the command processor). 


The same occurs after program execution when the EXEC loader releases the 
reserved memory space for further use, unless prevented by function 31H of 
interrupt 21H, called from the program. 


Now that you know some of the theoretical aspects of DOS memory management, 
here are descriptions of the most important of these DOS functions. Functions 
48H, 49H and 4AH are all called through interrupt 21H. The function number 1s 
passed in the AH register. 


Function 48H allocates memory. The function number is passed in the AH register 
and the number of paragraphs to be reserved (16 bytes per paragraph) is passed in 
the BX register. If the requested number of paragraphs can be reserved, the function 
returns with the carry flag clear. The AX register indicates the segment address of 
the reserved memory. Therefore, it starts at address AX:0000. If the program 
required more memory than was available, the carry flag is set following the call to 
the function and the AX register contains an error code. The BX register contains 
the maximum memory available in paragraphs. 


Function 49H performs the reverse of function 48H. This function releases 
memory previously reserved through function 48H. The segment address of the 
memory area to be released is passed in the ES register. This segment address was 
originally passed in the AX register when function 48H was called. Normally 
function 49H should execute without errors and the carry flag should be reset after 
the function call. If this is not the case, it could be caused by either a destroyed 
data block (placed ahead of a memory area by DOS), or a segment address passed in 
the ES register which doesn’t match a reserved memory area. 


A third function changes the size of memory area which had been previously 
reserved. The memory area can be either enlarged or reduced by using function 
4AH. The segment address of the area to be modified is passed in the ES register. 
The BX register reserves the number of paragraphs (16-byte units) which the 
memory area should contain. The register contents following the call to the 
function are identical to those of function 48H. 


Since calling DOS functions is relatively easy as far as memory management is 
concemed and no special tricks are required, the following program 1s dedicated to a 
different topic, which also relates to DOS memory management. We're talking 
about a program that pokes around the system and checks all allocated memory as 
well as its contents. The program is intelligent enough to differentiate between 
storage areas that contain the environment of a program, a PSP, or other 
information. 
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The assignment of this program is to go through the memory from MCB to MCB 
and examine the allocated storage areas. In order to move to the next MCB each 
time, it uses the third field within an MCB, which helps it point to the next 
MCB. This sets up a loop which will run until the last MCB is discovered, which 
will have the letter "Z" in its ID field. 


But in order to move through the chain of MCBs, the address of the first link, that 
is the first MCB, must be known. DOS lists this within an internal structure 
called DIB (DOS Information Block), which is not normally accessible to 
application programs, i.e. this represents an undocumented DOS feature (see also 
Section 6.15). However, we can find out the address of this structure with the help 
of function 52H, which will output the address to the ES:BX register pair when 
called. 


Curiously, this address points to the second field in the MCB rather than the first. 
But since it's the first field that contains the address of the first MCB, the 
information we're looking for is behind the pointer. Since the pointer on the first 
MCB consists of an offset address and a segment address, it is four bytes long and 
can therefore be found at the address ES:(BX-4). But be careful with the address 
statement, because it makes it seem as though all you have to do is subtract 4 
from the contents of the BX register in order to get the effective address of the 
desired information in the ES:BX register pair. This will only be successful if the 
offset address in the BX register is greater than or equal to 4. But if it is less than 
4, the consequences are disastrous, because this leaves a negative number. There is 
no such thing as a negative memory address. Let's use an example to make this 
clear: 


If the value 0 is returned to the BX register as the offset address of the DIB, the 
subtraction would give the value OFFFCH. With arithmetic operations, this is 
interpreted quite correctly as -4. However, during memory access, this will not 
point to the address -4, but rather right to OFFFCH, and therefore to the end rather 
than the beginning of the accompanying segment. Of course, you won't find what 
you're looking for there. 


The program will help you here, first of all by decrementing the delivered segment 
address by 1. This reduces the effective address, which you get by appending the 
segment address and the offset address, by 16. Finally, by adding 12 to the offset 
address, the effective address is reduced by only 4 and points to the desired memory 
location. The address of the first MCB can then be taken from this memory 
location without any problems. 


The loop which runs through all MCBs and analyzes them begins with this 
address. First, some status information on the MCB and the memory it controls is 
given. This includes: 


° the MCB number 
° its address in memory 
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° the address of the memory it controls 

° the contents of the ID field ("M" or "Z") 

° the address of the accompanying PSP (independent of whether it 
even exists) 

° the size of the accompanying storage area in paragraphs and bytes 


Next, the contents of the storage area that belongs to it are examined. We get its 
address by incrementing the segment address of the MCB by 1. The first thing 
we'll determine is whether we're dealing with an environment block in this storage 
area. We'll know for sure if we find the string COMSPEC= at the beginning of the 
area. This string starts every environment block. If this string is found, the 
program proceeds as though this were indeed an environment block, and it lists the 
individual environment strings. In front of these, it lists the name of the program 
the environment block belongs to, which is located at the end of the environment 
block for DOS version 3.0 and higher. 


If the storage area cannot be identified as an environment block, we could possibly 
be dealing with a PSP, and therefore a transient or resident program. The program 
will start from here if it finds the machine language command INT 20H (code 
OCDH, 020H) in the first two positions of the memory range. This command 
starts every PSP. 


If the program also does not run into this, it can't tell if the memory range 
contains program code, data, or whatever. In this case, the program will send the 
first 80 bytes of the storage area to the screen as a hex and ASCII dump, in order 
to give you a chance to figure it out for yourself. 


After this, the user is prompted to strike any key. When the keystroke is received, 
the next MCB is examined, and the program will finally end when the last MCB 
has been handled. 


The following programs in Pascal and C produce the MCB dump. A BASIC 
version could not be implemented here because this program works its way 
through the entire memory, and BASIC offers only the DEF, SEG and PEEK 
commands for this purpose. The use of these commands is too awkward in this 
case and would detract from the real task of the program. 


Since both programs are very similar in terms of the logic, function calls, and 
variables used, they are described together in the following section. 


Both access memory with FAR pointers, since the storage areas to be addressed are 
outside of their data segments. While Turbo Pascal automatically uses FAR 
pointers, C requires selection of the appropriate memory configuration through 
Compact, Huge, Large or with the help of Cast operations, each of which 
explicitly defines the task with a FAR pointer. This program goes the latter way, 
so that it may also be compiled in a memory configuration that works with NEAR 
pointers by default (Tiny, Small, Medium). 


123 


6. The Disk Operating System PC System Programming 


Pascal 
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Converting separately retrieved offset and segment addresses to one FAR pointer 
presents a problem in both languages. This can be done in C with a macro, which 
is already defined in the Include file DOS.H in Turbo C, but is missing in 
Microsoft C. For this reason, the macro is defined within the C program, in case it 
hasn't been previously defined. In Pascal, the address conversions happen with the 
help of a small inline procedure, that enters both addresses directly into the 
memory locations that form the pointer. 


Beyond these brief remarks, the listings should be able to speak for themselves, 
since they are fully documented. 


listing: MEMP.PAS 


{RRR KEE KKK KEE KEK EKER KEKKEREK KKK KEKE KEK KEKE K KKK KK KKK KKK KEKKEKKEKKEKKEKEKEKEKEKE | 
{* MEM P a 
{* ss eis i chines si Un Swi “iim ees am su’ Gh Sn ti ins nis Ss es ss ce ‘ncn ces nb cmch sw ik cc is ese cena em ss ee cs cw es sass wes ew OO Me Re *} 
{* Description : displays the memory blocks allocated by DOS. *} 
{* ‘is si te cms em i's Sm ee mame, smn nem sob icin “im si el cme xo is icc mms Gs © em ees Ss sp rp im Wm amc ee ‘ns seis we te Gm em og Soe SP el oe a inne ei ent *} 


{* Author : MICHAEL TISCHER  *} 
{* developed on : 08/22/1988 =) 
{* last update : 08/22/1988 a4 


{ RRR K KERR KERR KEKE K KEKE K RRR KEK IKKE EKER KEK KKK AK KEKE KKKKKEKKEKEKKEKEKKKE | 


program MEMP; 


uses DOS, CRT; { bind in the DOS and CRT units } 
type BytePtr = “byte; { pointer to a byte } 

Range = array[0..1000) of byte; { an area, anywhere in RAM } 
RngPtr = “Range; { pointer to an area } 

MCB = record { a memory control block } 
IdCode : char; { "M“ = a block follows, "Z" = end } 
PSP : word; { segment address of the PSP } 
Distance : word; { number of paragraphs - 1 } 

end; 

MCBPtr = “MCB; { pointer to an MCB } 
MCBPtr2 = *MCBPtr; { pointer to an MCBPtr } 
HexStr = string[4]; { stores a four-digit hex string } 
var CvHStr : HexStr; { stores the converted hex string } 


{ RRA RR RRR E RIKER KEKE KKK KEIR HERI KRKKKRKAKKKKERERAKKIKKKEKEKKKEKKEE | 
{* GetDosVer: determines the DOS version *} 
{* Input : none *} 
{* Output : the DOS version number (30 for DOS 3.0, 33 for 3.3 etc.) *} 


{RRR RRR RE KR K RRR R RE KKK KEK KEK RK KERR RE KKERKEKEKR KER KEKE KEKE KE } 


function GetDosVer : byte; 


var Regs : Registers; { stores the processor registers } 
begin 
Regs.ah := $30; { function no. for “Get Dos Version" } 
MsDos( Regs }; { call DOS interrupt $21 } 
GetDosVer := Regs.al * 10 + Regs.ah; { get version number } 
end; — . 


{ FARR RHEE REE KERR KKK KEK ERE KREREREKREKK KKK EKRERKEKRKKKEKEKKEKEKRKEEKKEEKKKKKKKKKK | 


{* MK FP: creates a byte pointer out of the segment and offset *} 
{* addresses passed. a 
{* Input : ~ Seg = segment to which the point should point *} 
{*. - Ofs = offset address to which the pointer should point *} 
{* Output : the pointer *} 
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{* Info : The pointer returned can be cast to any type pointer *} 
‘Pee eee eee ee ee eee eee eee ee Lee SES CRE SE SSE ESE SCE LER EEE C RE SE SERS ES ee SESE SS 
{ } 


{SF+} { This routine is intended for the FAR model and is } 
{ also suited for binding into a unit. } 


function MK FP( Seg, Ofs : word ) : BytePtr; 


begin 
inline ( $8B / $46 / $08 


/ mov ax, [bp+8] (get segment address) 
$89 / $46 / SFE / 

/ 

) 


} 

mov [bp-2],ax (and put in pointer) } 

$8B / $46 / $06 } 
$89 / $46 / SFC } 


mov ax, [bp+6] (get offset address) 
mov [bp-4],ax (and put in pointer) 


—_er a? pi 


end; 


{SF-} { NEAR routines possible again } 


{ HRA KK RR RRR IRR HIKE KRHA KIKI RK KKK RAK EKK KEKE KERRIER KKKEKKEKER | 
{* HexString: creates a 4-digit hex string out of the number passed *} 


{* Input : ~ HexVal = the number to be converted *} 
{* Output : the hex string *] 


{ RR RHI RHR KK IKI KK III KIKI AIK IK IKI KIKI KKK I RIKER IK IKEA KK IKKE KKIKEE | 


function HexString( HexVal : word ) : HexStr; 


var Counter, { loop counter } 
Nibble : byte; { the lowest nibble of the word } 
begin 
CvHStr := 'xXxxx'; { initialize the string } 
for Counter:=4 downto 1 do { run through the 4 digits of the string } 
begin 
Nibble := HexVal and $000f; { leave just the lower 4 bits } 
if (Nibble > 9 ) then { convert to a letter? } 
CvHStrf{ Counter ] := chr(Nibble - 10 + ord('A‘)) { yes } 
else { convert to a number } 
CvHStr[{ Counter ] := chr(Nibble + ord('0')); 
HexVal := HexVal shr 4; { shift HexVal 4 bits to the right } 
end; 
HexString := CvHStr; { return the created string } 
end; 


{ FR RK IK IK I IK RRR RIK KR KK RIK IKK IK KK IK IK TKK IK KIT TK IK KKK HIKE KKK KKK KKK EK} 


{* FirstMCB: Returns a pointer to the first MCB. *} 
{* Input : none *} 
{* Output +: pointer to the firs MCB ba 


{ BARR H RRR KKK IRI KKK ARIK HIKARI KIKI KH KRHA AK IKK KIER IK KKK KAKA IKK KKK | 


function FirstMCB : MCBPtr; 


As 


var Regs : Registers; { stores the processor registers } 
begin 
Regs.ah := $52; { ftn. no.: get address of the DOS info block } 
MsDos( Regs ); { call DOS interrupt $21 } 
{*-- ES: (BX-4) points to the first MCB, create pointer ------------- *} 


FirstMCB := MCBPtr2( MK FP( Regs.ES-1, Regs.BXt1l2 ) )%; 
end; 


{ BARR RR H HR I KK EKEK KEK RE RHEE ERK KERR EK KEK KK KEKE KER EKER KKK ERE KKK EKER ERERE | 


{* Dump: outputs hex and ASCII dump of a memory block. *} 
{* Input : - DPtr = pointer to the memory block to be dumped =) 
{* - Num = number of lines to dump (16 bytes each) *)} 
{* Output : none *} 


{ FA AAKRHKHKHKKRKRK KKK KEK KEKE KKK KKK IKKE KKK KKK EKER KEK KKK EKER EK KEKEKKKEKHKEKEKR | 


procedure Dump( DPtr : RngPtr; Num{Num} : byte); 
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type HBStr = string[2]; { stores 2-digit hex numbers } 
var Offset, { offset in the memory block } 
Z : integer; { loop Counter } 
HexStr : HBStr; { stores a hex number for hex dump } 


procedure HexByte( HByte : byte ); 


begin 
HexStr[1] := chr( (HByte shr 4) + ord('0O') ); { first digit } 
if HexStr[1] > '9* then { convert to letters? } 
HexStr{1] := chr( ord(HexStr[{1]) + 7 ); { yes } 
HexStr[2] := chr( (HByte and 15) + ord('0') }; { second digit } 
if HexStr[{2] > '9' then { convert to letters? } 
HexStr[2] := chr( ord(HexStr[2]}) + 7 ); { yes } 
end; 
begin 
HexStr := 'zz'; { initialize the hex string } 
writeln; 
write (‘DUMP | 0123456789ABCDEF 00 01 02 03 04 O05 06 O7 08"); 
writeln(' 09 OA OB OC OD OE OF'); 
write ('----- fm rn re rrr ere *)? 
writeln (' ------- 22 enn nnn nn n= 7 
Offset := 0; { start with the first byte in the block } 
while Num>0 do { run through the loop ANZ times } 
begin 
write (HexString(Offset), ' | ')? 
for 2Z:=0 to 15 do { process 15 bytes } 
if (Dptr*(Offset+Z] >= 32) then { valid ASCII character? } 
write( chr (Dptr*[(Offset+Z]) ) { yes, output character } 
else { no } 
write(' '); { output space instead of character } 
write (' ‘)% { set cursor to the hex portion } 
for Z:=0 to 15 do { process 15 bytes } 
begin 
HexByte( Dptr*[(Offset+Z] ); { convert byte to hex } 
write (HexStr, ‘ '); { output hex string } 
end; 
writeln; 
Offset := Offset + 16; { set offset in the next line } 
Dec( Num ); { decrement number of remaining lines } 
end; 
writeln; 
end; 


{RARER RRR EK RRR RE KKK KEK KEKE RE KER EERE RK ERK KEK KKK KEKE KKK KEKKEEKKEKKEKKK KEK } 


{* TraceMCB: runs through the list of MCB‘s. a 
{* Input : none *} 
{* Output : none | 


{RAK RERKE EKER KEK KKK KEKE KEK KEK ERK KKK KEK KEKE KKK KKK KKK KEKE KKEEKKEKKKEKKEE | 
procedure TraceMCB; 
const ComSpec : array[0..7] of char = 'COMSPEC='; 


var CurMCB{CurMCB} : MCBPtr; 


Done : boolean; 
Key * char? 
NYMCB, { number of current MCB } 
Z : integer; { loop counter } 
MemPtr : RngPtr; 
DosVer : byte; { DOS version number } 
begin 
DosVer := GetDosVer; { get DOS version } 
Done := false; 
NrMCB := 1; { the first MCB is number 1 } 
CurMCB := FirstMCB; { get pointer to the first MCB } 
repeat { follow the MCB chain } 
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if CurMCB*.IdCode = 'Z' then { last MCB reached? } 
Done := true; { yes } 
writeln('MCB number = ', NYMCB); 


writeln(‘MCB address = ', HexString (seg (CurMCB*%)), 's', 
HexString (ofs (CurMCB*)) ); 


writeln(‘Memory addr. = ', HexString(succ(seg(CurMCB*))), ‘:', 
HexString (ofs (CurMCB*)) );7 
writeln('ID = ', CurMCB% .IdCode) ; 
writeln(‘PSP address = ', HexString (CurMCB*.PSP), ':0000'); 
writeln('Size = ‘, CurMCB’.Distance, ‘ paragraphs ', 
‘( ', longint (CurMCB*.Distance) shl 4, ‘ bytes }'); 
write ('Contents = ')> 
{*-- is it an environment? ---~--------------~---------------------- *} 
Z := 0; { start the comparison at the first byte } 


MemPtr := RngPtr(MK_FP(succ (Seg(CurMCB%)), 0)); { pointer in RAM } 
while ( (2<=7) and (ord(ComSpec[Z]) = MemPtr*[Z]) ) do 


Inc (2); { set Z to the nest character } 
1f 2>7 then { was the string found? } 
begin { yes, this is an environment } 


writeln(‘environment'); 
MemPtr := RngPtr (MK _ FP (succ (Seg (CurMCB*)), 0)); 


if DosVer>= 30 then { DOS Version 3.0 or higher? } 
begin { yes, get program name } 
write('Program name = '); 
Z 3= 0; { start with the first byte } 
while not( (MemPtr*[{Z2]=0) and (MemPtr*[Z+1]J=0) ) do 
Inc( Z ); { search for empty string } 
Z2:= 2+ 4; { set Z to the start of the prog name } 
if MemPtr*[2]<>0 then { is there a prog. name here? } 
begin 
repeat { run through the program name } 
write( chr(MemPtr*[Z]) }; { output characters } 
Inc( 2 ); { process the next character } 
until MemPtr*[Z]=0; { to the end of the string } 
writeln; 
end 
else { program name not found } 
writeln ('unknown') ; 
end; 
{*-- output the environment strings -------------------------- *} 


writeln (#13,#10, ‘Environment strings'); 


Z 3:= 0; { start with the first byte in the allocated block } 
while MemPtr*[Z]<>0 do { repeat until empty string } 
begin 
write (' T}3 
repeat { output a string } 
write( chr (MemPtr*[Z]) )3; { print a character } 
Inc( Z ); { process the next character } 
until MemPtr*{2]=0; { to the end of the string } 
Inc( 2 ); { set to the start of the next string } 
writeln; { end line } 
end 
end 
else { no envrionment } 
begin 
{*-- is it a PSP? -------------------------------------------- *} 
{*-- (starts with command INT 20 (code=SCD $20)) ------------- *} 


MemPtr := RngPtr (MK FP (succ(seg(CurMCB*)), 0)); { set pointer } 
if ( (MemPtr*[0]=SCD) and (MemPtr*{1]=$20) ) then 


begin { it's a PSP } 
writeln(‘PSP (with program following) '); 
end 
else { the command INT 20 was not found } 
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begin 
writeln('unidentifiable (program or data)'); 
Dump( MemPtr, 5); { dump the first 5x16 bytes } 
end; 
end; 
Write ('s=seescescsssessesssessessessssessseese=s') s 


if ( not Done ) then 


begin { set pointer to the next MCB } 
CurMCB := MCBPtr (MK FP (seg(CurMCB*) + CurMCB*.Distance + 1, 0)); 
Inc (NrMCB) ; { increment the number of the MCB } 
Key := ReadKey; 
end; 
until ( Done ) { repeat until the last MCB is processed } 


end; 


{ ARKH HARRAH IKK KEK KKK KKK IKKE EKER KKK KEK KKK KKKK HARE KEKE KEKREKEKKEEKKEEE | 


(a MAIN PROGRAM >} 


{ RARER REAR KER KKK HERE KEKERKKRERKIKKEKRKKIKRKKRIAKIARKEKEKKEKKEKEKKKKKEKKEKE } 


begin 
ClrScr; { clear the screen } 
TraceMCB; { run through the MCBs } 
end. 


C listing: MEMC.C 


[RRR EKKEKKKERK KIRKE KEK IK KKK KKK KEKE KEK KEKE KKK ERK KK KKK KEKE KEKE KEKE KKKKKEKEK / 


/* MEMC */ 
/* a cn a ss cs ee ib ts ain emo cl stn eran‘ i <a ein smh ee ev srs cs nb eS ems Si <i mui ab eam me im cs a es aw es sm nu Sto’ */ 
/* Description : Displays the memory blocks allocated by DOS wif 
/* (Ss cass ea ces Saw “sos ess es Sus cow Sas Sew Sess Sms cei. nas ws sh > ems i 0 isis as lek mes maaw cw eis sd ces Ss deni cs ee Ges ee ss le NO a Oe x/ 
/* Author : MICHAEL TISCHER */ 
7* developed on : 08/23/1988 */ 
/* last update : 05/12/1989 */ 
/* i i ns es ann eS ms mee i cows cos ms Ss ee as se es es sean net ce al Ges se cas cee es src a eis eons ses ee ee es x/ 
[* (MICROSOFT C) x] 
/* creation : CL /AS /Zp memc.c A 
Ve call : MEMC */ 
/* ae ca conse ora Sisco cre ao ls ents wh ane ai ns Sas mae Sem Ss ess meas Sees a ees Ss Sas es se aks mamnim is ms sce a wd msn ss ec ew os x/ 
{* (BORLAND TURBO C) */ 
{* creation : via the Compile-Make command a 
/* (no project file) */ 


[RRR RRR KIRK RIKI IKK IKI KIKI KI KIKI KK IIHR IT KIKI IK IKK IKKE KKK KKK / 


#include <dos.h> 
#include <stdlib.h> 


typedef unsigned char byte; /* build ourselves a byte */ 

typedef unsigned segadr; /* a segment address */ 

typedef byte boolean; 

typedef byte far *FB; /* FAR pointer to a byte */ 

#define TRUE 1 /* needed for working with boolean */ 

#define FALSE 0 

struct MCB { /* describes an MCB in memory */ 
byte id_code; /* 'M' = a block follows, 'Z' = end */ 
segadr psp; /* segment address of the PSP */ 
unsigned distance; /* number of paragraphs reserved */ 
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}; 


typedef struct MCB far *MCBPtr; /* FAR pointer to an MCB */ 


#ifndef MK FP /* was MK FP defined already? */ 
#define MK FP(seg, ofs) ((void far *) ((unsigned long) (seg) <<16| (ofs))) 
#fendif 


[RRR RRR EIR KKK KKK IKKE IKK KKK KEKE IKKE KKK KKK KKK KEKE EKKEKK KKK KK 
kkk 


* Function > FIRST _ MCB - 
1 ead ae oe ENS OR ee RP ON ae ss a eds ea eee eee ee ea ak 
* Description : Returns a pointer to the first MCB. * 
* Input parameters : none x 
* Return value : Pointer to the first MCB * 


WHR HK IKK IKI RIKKI KIKI IK III KIKI RHI HIKARI EKKAKEAKREK 
aaKK / 


MCBPtr first_mcb() 
{ 


union REGS regs; /* stores the processor registers */ 
struct SREGS sregs; /* stores the segment registers */ 
regs.h.ah = 0x52; /* ftn. no.: get address of the DOS info block */ 
intdosx( &regs, &regs, &sregs }; /* call DOS interrupt 0x21 */ 
/*-- ES: (BX-4) points to the firs MCB, create pointer -------~------- es 


return( *((MCBPtr far *) MK FP( sregs.es-1, regs.x.bx+1l2 )) ); 
} 


[RRR KEKKRKEKKKKK KKK KEKE KKEKEKKEKKEKEKKKKEKKKKEKEKEKKKKKKKEKKEKEKEKEKKKKKKKK KEK 


* Function >: DUMP * 
POI as So a ee a es ls ee ee a ds Bs a ee Se eet oe ee ee kk 
* Description : Outputs hex and ASCII dump of a memory range. " 
* Input parameters : - bptr : pointer to a memory area * 
be - num: number of dump lines (each 16 bytes) * 
* Return value : none * 


HARK KKK KKK KI KKK RK KKK KKK IK KI IKI IKK IKK KKK KIKI KK KER KKE KEKE IKKEKRHEEKEKKKKE / 


void dump( FB bptr, byte num) 
{ 


FB lptr; /* running pointer for printing a dump line */ 
unsigned offset; /* offset address relative to BPTR */ 
byte i; /* loop counter */ 
printf ("\nDUMP | 0123456789ABCDEF 00 01 02 03 04 05 06 07 08"); 
printf (" 09 OA OB OC OD OE OF\n"); 

printf ("----- +o----- - ~~ + - ee + wy 
printf ("--------~----~---- \n") + 


for (offset=0; num-- ; offset += 16, bptr += 16) 

{ /* run through the loop NUM times */ 

printf ("%04x | ", offset); 

for (lptr=bptr, i=16; i-- ; ++lptr) /* print character as ASCII */ 
printf (*%c", (*lptr<32) 2? ' * : *lptr); 

printf (" a 

for (lptr=bptr, i=16; i--; ) 
printf ("%02X ", *lptr++); 

printf ("\n"); /* move to the next line */ 


/* output character as hex */ 


[RRR RK REE KKKEKKRKEKEKKKEKKKKK KKK KKK KKK KEKE KE KKK KEK KKK KEKEKKKEKKKKKKEKKKKR 


* Function 2-2 RACE... “MCB ‘i 
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* Description : Traces the chain of MCB's. ” 
* Input parameters : none > 
* Return value : none * 


FHI HIKER IKI KKK KKK KKK KKK KKK KKK KEK IKK KEKE KEK KKK KEK KEKE KEKEKEKKEKKEKKEKKE / 


void trace_mcb() 
{ 
static char fenv[] = { /* first environment string */ 
or *O*% bal Gare rey ar ‘E', Ct, to 6 


MCBPtr cur_mcb; /* pointer to the current MCB */ 
boolean done; /* TRUE if the last MCB was found */ 
byte nr_mchb, /* number of the current MCB */ 
5 /* loop variable */ 
FB lptr; /* running pointer in the environment */ 
done = FALSE; /* now we get going */ 
nr_mcb = 1; /* the first MCB is number 1 */ 
cur_mcb = first_mcb(); /* get pointer to the first MCB */ 
do /* process-the individual MCB's */ 
{ 
if ( cur_mcb->id_code == '2' ) /* last MCB reached? */ 
done = TRUE; /* yes */ 
printf ("MCB number = $d\n", nr_mcbt+); 


printf ("MCB address $Fp\n", cur_mcb); 
printf ("Memory addr. = %Np:0000\n", FP _SEG(cur_mcb) +1); 


printf ("ID = $c\n", cur_mcb->id code); 

printf ("PSP address = $Fp\n", (FB) MK_FP (cur _mcb->psp, 0) ); 

printf (“Size = $u paragraphs ( %lu bytes )\n", 
cur_mcb->distance, (unsigned long) cur_mcb->distance << 4); 

printf ("Contents ate 

/*-~ is it an environment? -------------- nnn ne re nn rrr * |. 


for (i=0, lptr=(FB)cur_mcb+16;/* compare first ENV string with FENV */ 
( i<sizeof fenv ) && ( *(lptr++) == fenv[it+tt+] }) 7; ) 
? 
if ( 1 == sizeof fenv ) /* was a string found? */ 
{ ; /* yes, it's an environment */ 
printf ("environment \n") ; 


if ( osmajor >= 3 ) /* DOS version 3.0 or higher? */ 
{ /* yes, get program name */ 
printf("Program name = "); 
for ( 7 !(* (lptrt++)==0 && *lptr==0) ; ) 
; /* find last ENV string */ 
if ( *(lptr += 3) ) /* is there a program name here? */ 
{ /* yes */ 
for (; *lptr ; ) /* run through the program name */ 
printf( "tc", *(lptr++) ); /* output a character */ 
} 
else /* no program name was found */ 
printf ("unknown") ; 
printf ("\n"); /* move to the next line */ 
} 
/*-- output the environment strings ------------------------------ w/ 


printf ("Environment strings\n"); 
for (lptr=(FB) cur_mcb +16; *lptr ; ++lptr) 
{ /* output a string */ 


printf (" Ld 
for ( ; *lptr ; ) /* run through the string to a NUL character */ 
printf( “%c", *(lptr++) )>; /* output a character */ 
printf ("\n"); /* move to the next line */ 
} 
} 
else /* no envrionment */ 


{ 
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/*- is it a PSP? --------~-~------------~+-------~-------~+---------- 
/*-- (introduced with the command INT 20 (Code=0xCD 0x20)) ------- 


if (*((unsigned far *) MK_FP( cur _mcb->psp, 0 )) == 0x20cd) 
printf ("PSP (with subsequent program) \n") ; /* yes 
else /* the command INT 0x20 was not found 


{ 
printf(“unidentifiable (program or data) \n"); 


dump( (FB) cur_mcb + 16, 5); /* dump the first 5x16 bytes 
} 
} 
pr i nef { 0 ee ee ee ee ee eS ) 7 
if ( !done ) /* another MCB? 


{ /* yes, set pointer to the next MCB 
cur mcb = (MCBPtr) 
MK FP( FP_SEG(cur_mcb) + cur_mcb->distance + 1, 0 ); 
getch (); /* wait for a key 
} 
} 
while ( !done ); /* repeat until the last MCB has been processed 


} 


“7 
a 


es 


as, 


[RIKI RIK IIR IK IKK IKK IK ITI I IKK IK IKK KIKI IT KIKI KIKI KKK IKKE IKKE KKK KKK / 


Le MAIN PROGRAM AES 


LEHR K KKK KK KIKI KK KEKE KEK KIKI KK KEK RE KKK IKKE KEK KEKE KKK KKK / 


void main() 


{ 
printf ("\nMEMC (c) 1988 by Michael Tischer\n\n"); 


trace_mcb({); /* trace the chain of MCB's */ 


} 
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6.10 DOS Filters 


SORT 
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Filters are programs, routines or utilities which accept input and modify the data 
for output. Filters do the same on the operating system level: characters are passed 
to these filters as input, the filters modify the characters then send the modified 
characters as output. This manipulation takes many forms. Filters can sort data, 
replace certain data with other data, encode data or decode data. 


DOS has three basic filters available: 

FIND _ searches input for a specified set of characters 
SORT arranges text or data in order 

MORE formats text display 


These filters perform simple redirection of standard input/output. They read 
characters from the standard input device, manipulate the characters as needed, then 
display them on the standard output device. The standard input device under DOS is 
the keyboard, and the standard output device is the monitor. DOS versions of 2.0 
and higher allow the user to redirect the standard input/output to files. Therefore, a 
filter can read characters from the keyboard or from a file, depending on the standard 
input device selected. This is possible by using a filter in conjunction with one of 
the DOS handle functions for reading and writing. DOS offers five handles: 


(Os | Standard input CON (Keyboard) 


Standard output CON (Screen) 
Standard error output CON (Screen) 


| Standard serial interface AUX 
Standard printer PRN 


If the user calls a program from the DOS level, the < character redirects input and 
the > character redirects output. In the following example, the input comes from 
the file IN.TXT instead of the keyboard. The output is written to the file 
OUT.TXT instead of the screen: 


sort <in.txt P>out.txt 


After the user enters the above command, DOS recognizes that a program named 
SORT should be called. Then it encounters the expression <IN.TXT which 
redirects the standard input. This occurs by assigning the handle O (standard input, 
which formerly pointed to the keyboard) to the file IN.TXT. The expression 
>OUT.TXT resets handle 1 to the OUT.TXT file instead of the screen. The affected 
handle is first closed, and then the redirected file is opened. 


Abacus 
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Pipes 


Once the command processor finishes with the command line it calls the SORT 
program using the EXEC function (DOS function 4BH). Since the program called 
with the EXEC function has all the handles of the calling program available, the 
SORT program can input/output characters to handles 0 and 1. Where the 
characters originate is unimportant to the program. 


After the SORT program completes its work, it returns control to the command 
processor. The command processor resets the redirection and waits for further input 
from the user. 


The filter principle as supported by DOS becomes especially powerful through 
pipes. This expression comes from the idea of a pipeline used for transporting oil 
or gas. DOS pipes have a similar function: they carry characters from one program 
to another and permit the connection of various programs with each other. 


When this happens, characters output from one program to the standard output 
device can be read by another program from the standard input device. As in the 
redirection of the standard input/output, the two programs do not notice the 
pipelines. The difference between the two procedures is that under redirection of the 
standard input/output devices, data can be redirected only to one device or file, 
while the use of pipes allows data transfer to another program. 


Combined filters 


Pipes allow the user to connect multiple filters. The pipe character | is inserted 
between the programs to be connected. An example should make this more 
understandable: A text file named DEMO.TXT is sorted and then displayed on the 
screen in page format. Even though this task appears to be very complicated at 
first, it can be performed easily using two DOS filters: SORT and MORE. SORT 
sorts the file and MORE displays the file on the screen in page format. 


The question is, how can you tell the command processor to do these things? First 
SORT is used. This filter is told to sort the file DEMO.TXT. The redirection of 
standard input can be used as illustrated at the beginning of the chapter: 


SORT <DEMO. TXT 


After the user enters this command, SORT sorts the file DEMO.TXT then 
displays the file on the screen. This display would be much easier to read in page 
format. Formatted output can be implemented by redirecting the output from 
SORT to a file (for example TEMP.TXT) and displaying this file using the 
MORE command. The following sequence of commands do this: 


SORT <DEMO.TXT >TEMP.TXT 
MORE <TEMP.TXT 
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You can use a pipe to connect the SORT filter and the MORE filter, saving the 
user typing time. The following command line sends the output from SORT 
directly to MORE and immediately displays the sorted file in page format: 


SORT <DEMO.TXT | MORE 


Any number of filters can be connected using pipes. DOS always executes these 
pipelined filters from left to right. It sends the output from the first program as 
input to the second program, the second program's output as input to the third 
program, etc. The last program can again force the redirection of the output with 
the > character so that the final result of the whole program or filter chain travels 
to a file or other device instead of the screen. 


Note: DOS cannot send data from one filter directly to another because it 
would have to execute both filters simultaneously, and the current 
version of DOS doesn't have multiprocessing capabilities. Instead, 
the following method is used. The input calls the first filter and 
redirects its output to a pipe file. After the first filter ends its 
processing, it calls the second filter but redirects its input to the pipe 
file to read in the output from the first filter. This principle applies 
to all filters. The pipe file is stored in the current working directory. 


The word "dump" is a computer buzzword for a way to display the contents of a 
file in ASCII characters and/or hexadecimal numbers. The DUMP programs below 
performs this task as a filter. As the contents are displayed in ASCII format, 
DUMP differentiates between normal ASCII characters (letters, numbers, etc.) and 
control characters such as carriage return, linefeed, etc. These control characters are 
displayed in mnemonic form (e.g., <CR> for carriage return and <LF> for 
linefeed). This DUMP filter is fairly simple in structure, yet it can be very useful 
to quickly examine a file's contents. 


The structure of the DUMP program is typical for a filter. Since DUMP displays a 
maximum of nine ASCII characters and/or héxadecimal codes per line, it asks for 
nine characters by using the read function from the standard input device. If not 
enough characters are available, it reads what characters are available. DUMP 
places these characters in a buffer, then converts the characters into ASCII 
characters and hex codes. This buffer will accept a complete line of 78 characters. 
When the buffer processing finishes, the filter uses the handle to write to the 
standard output device. This process is repeated until no more characters can be read 
from the standard input device. 


The following programs are written in Pascal, C and assembly language. Note that 
there isn't a BASIC version. The reason is that BASIC, as an interpreted language, 
is unsuitable for developing a filter which can be called from the DOS level. A 
BASIC compiler would be required for this task. 
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Pascal listing: DUMPP.PAS 


{ HAAR RRR KEK KK IKK HIK KKK I KK RIKKI KK KKK RIKER KAKA AIK AKAIKE KKEKEE } 


(* DUMP P *} 
{* aS a a Sa a a ne ae ea ne anneal *} 
{* Task : a Filter, which reads in characters from the os 
{* Standard input device and outputs them *} 
{* as Hex and ASCII dump on *) 
{* the Standard output device *} 
{* a a i ae ee re sare ce me ae ete cn ee ae eee Oe ee ce ee ee ce me ee Se a ee we ee ee cee ee ee ee a a a ee ae *} 
{* Author : MICHAEL TISCHER x 
developed on 2 98/08/87 *} 
{* last Update : 05/04/89 *} 
{* a nn ns er ee ee *} 
{* Info : This program can only be called from the *) 
{* DOS level after compiling to an EXE file *} 
:* with TURBO *} 


{ BRR A RHR RR KK RRR RR IKK IKKE IKK IRIE KIRKE KERRIER EERE HKEEEKKKEE 


program DUMP; 


Uses Dos; { Add DOS unit } 
{$V-} { suppress length test on strings } 


const NUL = 0; ASCII-Code NUL-character 


{ } 

BEL = 7; { ASCII-Code Bell character } 

BS = 8; { ASCII-Code Backspace } 

TAB = 9; { ASCII-Code Tab } 

LF = 10; { ASCII-Code Linefeed } 

CR = 13; { ASCII-Code Carriage Return } 

EOF = 26; { ASCII-Code End of File } 

ESG 272 { ASCII~Code Escape } 

type SZText = string[3]; { passes the name of a special character } 
DumpBf = array[1..80] of char; { accepts the output Dump } 
{RRR RR RK K KKK ERK KK KKK KKK KEK KER KK KEKE KK KKKK KEKE KEKEKKKKKKKE | 
{* SZ : writes the name of a control character into a Buffer *} 
{* Input : see below ba 
{* Output : none *} 
{* Info : after the call of this procedure the pointer *} 
{* which was passed, points behind the last character of *} 
{* the control character name in the Dump-Buffer *} 


{RARER AK HARK HK ERR KEK KKH RKKKKRK IKKE KK KKK EKER AKKKAKEKEKKKEKEKKKKKKE | 


procedure SZ(var Buffer : DumpBf; { Text entered here } 
Text s SZTeEXts { Text to be entered } 
var Pointer : integer); { addr. of text in buffer } 
var Counter : integer; 
begin 
Buffer[Pointer] := '<'; { leads control character } 
for Counter := 1 to length(Text) do { transfer Text to Buffer } 
Buffer[{Pointer + Counter] := Text [Counter]; 
Buffer[Pointer + Counter + 1] := '>'; { terminates control char } 
Pointer := Pointer + Counter + 2; { Pointer to next character } 
end; 


{ RAAKKHKKHKKAERK AKER KEKE KEE KER EKER EKER KEKKEREKRKKEKKEKREKKEKEKKERKKKEE | 


{* DODUMP : reads characters in and outputs them as Dump *} 
{* Input : none *} 
{* Output : none *} 


{RAR ARH RRR RRR RRR RRR KKK ERK RK RIKI KR AK EKA KEKE KEKREKHKKIKEREKKE | 


procedure DoDump; 
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Endc := false; { not the End } 
repeat 
Regs.ah := $3F; { Function number for reading handle } 
Regs.bx := 0; { the Standard input device is handle 0 } 
Regs.cx := 93 { read in 9 characters } 
Regs.ds := seg(NewByte) ; { Segment address of the buffer } 
Regs.dx := ofs (NewByte) ; { Offset address of the buffer } 
MsDos( Regs }; { Call DOS-Interrupt 21H } 
if (Regs.ax = 0) then Endc := true; { no character read? } 
if not (Endc) then 
begin { NO } 
for Counter := 1 to 30 { Fill buffer with blanks } 
do DumpBuf [Counter] := ' '; 
DumpBuf[31} := #219; { Place Separator between Hex and ASCII 
NextA := 32; { ASCII-characters follow separator 
for Counter := 1 to Regs.ax do { start processing characters 
begin { read in 
HexChr := ord (NewByte[Counter]) shr 4 + 48; { Hex top 4 bits 
if (HexChr > 57) then HexChr := HexChr + 7; { convert char 
DumpBuf [Counter * 3 -— 2] := chr (HexChr); { store in buffer 


HexChr := ord (NewByte[Counter]) and 15 + 48; { Hex bot. 4 bits 
if (HexChr > 57) then HexChr := HexChr + 7; { convert number 


Reh et et met geet eye eet et get Get eget et ee tet ee et ee es ee 


DumpBuf [Counter * 3 — 1] := chr (HexChr); { store in buffer 
case ord (NewByte[Counter]) of { test ASCII-Code 
NUL : SZ(DumpBuf, 'NUL', NextA); { NUL-character 
BEL : SZ(DumpBuf, 'BEL', NextA); { Bell character 
BS : SZ{DumpBuf, ‘BS' , NextA); { Backspace 
TAB : SZ(DumpBuf, ‘TAB', NextA); { Tab 
LF : SZ(DumpBuf, 'LF' , NextA); { Linefeed 
CR : SZ(DumpBuf, ‘CR' , NextA); { Carriage Return 
EOF : SZ(DumpBuf, 'EOF‘', NextA); { End of File 
ESC : SZ(DumpBuf, '‘ESC', NextA); { Escape 
else 
begin { normal character } 
DumpBuf [NextA] := NewByte[Counter]; { Store ASCII-character } 
NextA := succ (NextA) { Set pointer to next character } 
end 
end; 
end; 
DumpBuf [NextA] := #219; { Set End character } 
DumpBuf [NextA+1] := chr(CR); { Carriage-Return followed by Line- } 
DumpBuf [NextA+2] := chr(LF); { feed to buffer end } 
Regs.ah := $40; { Function number for writing handle } 
Regs.bx := 1; { Standard output device is handle 1 } 
Regs.cx := NextA+2; { Number of characters } 
Regs.ds := seg (DumpBuf) ; { Segment address of the buffer } 
Regs.dx := ofs (DumpBuf) ; { Offset address of the buffer } 
MsDos( Regs }; { Call DOS-Interrupt 21H } 
end; 
until Endc; { repeat until no more characters are available } 


end; 


{ REAR AKH KERR K RAK KKK KKK KKK KKK KKK ERK KEK KK KEK KKK KKKEKKKEKKKKEKK KKK K | 


i MAIN PROGRAM a 


{ MAAK RARER HERRERA KKK KKK IKK KKK KKK KKK KEK KRHA AKKE ERA HK KKK E KKK KK KY} 


begin 
DoDump; { Output Dump } 
end. 
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C listing: DUMPC.C 


[RRR KIKI KR I KIKI KK IKK IKK I KKK EKER KKK IIH IKK KKK KEKE KK EAE KEK / 


/* DUMPC */ 
/* a ees ee ns te Sa Sew es tn ‘ass ih mis ca Sars ts cle ss tesa mis es es sh wa sae re Sr ew wns i Ua a cm co re es eb ew a a lm a ia ae se es x/ 
a Task : a Filter which reads in characters from the */ 
{[* Standard input and outputs them as */ 
f* Hex and ASCII-Dump on */ 
/* the Standard output device tf 
Ph teeta ee et So Ot eae oe ae eo eae eee ee ae x/ 
{* Author : MICHAEL TISCHER ay 
fh deveioped on > 06/14/87 a4 
= last Update : 04/08/89 =/ 
/* i cs es tc meas am we ccs a eae se me Se es ce ew fs ces ns Ss ces ca Sn de ees ee ed x/ 
ue (MICROSOFT C) * 
, bs Creation : MSC DUMPC; x] 
ie LINK DUMPC; x/ 
/* Call : DUMPC [<Input] [>Output] x} 
/* ee cas sa ane cme GD cam GUD GED ES Es TT swe nts cvs ene Gans n> SEED GOP crv tr ene mb sit ns SD PEE fem Su nts GN eb END SAP Gee iv EY AEN NED GUUS EP sms ERG QED cD‘ am SND AO GED UN OS cs GED TD i SED GEN SUD cise ED CED NY x/ 
/* (BORLAND TURBO C) a 
[* Creation : tcc dumpc */ 
/* Call : DUMPC [<Input] [>Output] x} 


[BERRI KIKI IK IK IK IK KKK KAKI KIKI KK KKK KKK IKK KKK KKK KKK IKK KEK KKK KKK KKK / 


#include <stdio.h> /* include Header-files */ 
#include <dos.h> 


#define byte unsigned char 


#define NUL 0 /* Code of NUL-character */ 
#define BEL 7 /* Code of Bell a] 
#define BS 8 /* Code of Backspace-key */ 
#define TAB 9 /* Code of Tab-key x) 
#define LF 10 /* Code of Linefeed ay 
#define CR 13 /* Code of Return-key */ 
#define ESC 27 /* Code of Escape-key a 


#define tohex(c) ( ((c})<10) ? ((c) | 48) =: ((c) + 'A' - 10) )} 


[RRA IIKKKIIKRKK II KI IKK KIRK IK KKK KR IK IK IK KIKI IKK KK IKK KKK IKKE KKK / 
/* GETSTDIN: reads a certain number of characters from the Standard */ 


ce input device into a Buffer uy 
/* Input : see below *] 
/* Output : Number of characters read */ 


[RRR KEK IKKE KIRK KEK KKK KKK KKK KKK KKK KKK KKK KKK K KKK KKK KKK KKK / 


unsigned int GetStdIn(Buffer, MaxChar) 


char *Buffer; /* Pointer in Character-Vector, which accepts data */ 
unsigned int MaxChar; /* maximum of characters to be read in */ 
{ 
union REGS Register; /* Register-Variable for Interrupt-Call */ 
struct SREGS Segment; /* accepts the Segment register */ 
segread (&Segment) ; /* read content of Segment register */ 
Register.h.ah = 0x3F; /* Function number for */ 
Register.x.bx = 0; /* the Standard input device is handle 0 */ 


Register.x.cx = MaxChar; /* Number of Bytes to be read */ 
Register.x.dx = (unsigned int) Buffer; /* Offset address of Buffer */ 
intdosx(&Register, &Register, &Segment); /* Call Interrupt 21H */ 
return (Register.x.ax); /* Number of Bytes read to caller */ 
} 


[RRR KK KKK KKK KKK KKK KKK KKK KKK KEK KKK KEK KEKE KKK KAKA KKK KEK ERK KKKEKE / 


/* STRAP : Attach character to string “a 4 
/* Input : see below Ff 
/* Output : Pointer behind the last added character +7, 


[RRR KKEKAKKAK KICKER KIRK KKK KIKI KEKE KKK EHR AKRK KKK KKK / 
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char *Strap(String, Textpointer) 


char *String, /* the source string 
*Textpointer; /* Pointer to the text to be attached 

{ 
while (*Textpointer) /* repeat until '\O' detected 
*Stringt+ = *Textpointert+; /* transmit character 
return (String); /* Pass Pointer to calling function 


} 


PC System Programming 


*7 
wkd 


uA 
AT 
ef 


[RII III III KIKI RIK IRI KKK KIKI IK III III HR IKEA III K EKA KEK EKER IKKE / 


/* DODUMP : reads the characters in and outputs them as Dump 
/* Input +: none 
/* Output : none 


*/ 
Rf 
is 


[REAR KKK KR KKRIRKKHRHKE RIKKI KK IKKE KK KERRE REE KKK ERKE KEKE / 


void DoDump () 


{ 


char NewByte[9], /*Accepts the characters read 
DumpBuf [80], /* accepts a line of DUMP 
*NextAscii; /* points to next ASCII-~-character in the buffer 

byte i, /* Loop counter 
Readbytes; /* Number of bytes read in 

DumpBuf [30] = 219; /* Set separator between Hex and ASCII 


while {(Readbytes = GetStdIn(NewByte, 9)) != 0) 
/* as long as characters are available 


{ 


for (i = 0; i < 30; DumpBuf[i++] = ' '); 
/* Fill buffer with spaces 
NextAscii = &DumpBuf [31]; /* ASCII-characters start here 


for (i = 0; i < Readbytes; i++) 
/* process all characters read in 
{ 
DumpBuf [i*3] = tohex((byte) NewByte[i] >> 4); 
/* convert Code in Hex 
DumpBuf [i*3+1] = tohex((byte) NewByte[i] & 15); 
switch (NewByte[i]) /* evaluate ASCII-Code 
{ 
case NUL : NextAscii = Strap(NextAscii, "<NUL>"); 


break; 

case BEL : NextAscii = Strap(NextAscii, “<BEI>"); 
break; 

case BS : NextAscii = Strap(NextAscii, "<BS>"); 
break; 

case TAB : NextAscii = Strap(NextAscii, "<TAB>"); 
break; 

case LF : NextAscii = Strap(NextAscii, "<LF>"); 
break; 

case CR : NextAscii = Strap(NextAscii, "<CR>"); 
break; 

case ESC : NextAscii = Strap(NextAscii, "“<ESC>"); 
break; 

case EOF : NextAscii = Strap(NextAscii, "“<EOF>"); 
break; 


default : *NextAsciit++ = NewByte([i]; 
} 
} 


*NextAscii = 219; /* End character for ASCII representation 
* (NextAscii+l) = '\r'; /* Carriage-Return to End of buffer 
* (NextAscii+2) = '\O'; /* NUL converted to LF on output 
puts (DumpBuf) ; /* Write String on Standard output device 


} 
} 


*/ 


ee 


ef. 


nf 


*7 


*/ 


*7 
we 
ald 
a A 


[RIKI KIKI KR IK IT IKK TK KKK TK TKK RK IKK KEK KK IKK KKK KEK KKK ERK KK / 


aes MAIN PROGRAM 


an / 


[RRR KK KEKE KKK KEIR KHER EERE KK KEKE KK EKER KEK KKKKEKEKKKKKK / 
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void main () 
{ 


DoDump () ; /* Character input/output */ 
} 


Assembler listing: DUMP.ASM 


RRR KKK RRR KKK HRI RE KKK HK KKK KKH KKK KE KKK KKKK EK KKK KKK EEK KK KEKKEKKK KEKE » 
piss DUMP ay 
PR cs ees cn ees se nas Seas ln iki ai seins pce Gems Seen Cos cows Ss cch ai aig ice: ms cee Cenk cn Gams nb ie win ccs es cs ess Web ts cas Gu ls hs cms Cn sn nic es cn il ei en es Cac tein bie eid im “Se xe 
tf f 
red Task 2 -Aclalcer Which reads =haracterc. from the Standard tnnut «2 
7 and outputs them as Hex- and ASCII-Dump on “ 
z* the Standard output device a 
I as ess mas leas ee ne ed eae See ars Ges ns Sees ces asin Saks asa his ss Gin lms as cm cs cen ech wae ces ees me eee ae ceive hes ela uh tem ‘com emia Cals ees Sas pba els ease sntin vais wis as seas ai a ses em “eo es gs Nas ke 
tf g 
-s Author : MICHAEL TISCHER *s 
ae developed on : 08/01/87 eS 
a last Update : 04/08/89 wi 
an cnn a in es Cs es i Si sens Cen ents cs Gos sus Sm leh i Gem ca sa cou Cmts Si Sw sc ss Car i tesa a tm‘ een ses csc emcee ai Si ish aime cbs cam ms es ae ial 
7 assemble : MASM DUMPA; igs 
7% LINK DUMPA; ks 
ae (important)... EXE2BIN DUMPA DUMP.COM *; 
I a a oa co a a a aa es a ss we ws tse es es ese see ee eb es es a a ae ee ee a ee ee ee ke 
a t 
Ph Call : DUMP [<Input] [>Output] ~s 
FARRER HR ERE KEKE EKER EEE KKK EK ERE KEK K KEKE KKKKKEKEKRKEKE KEKE KKKKEKKEKEKEEK EE © C 


NUL equ 0 7; ASCII-Code NUL-Character 
BEL equ 7 7;ASCII-Code Bell 
BS equ 8 7;ASCII-Code Backspace 
TAB equ 9 ;ASCII-Code Tabulator 
LF equ 10 ;ASCII-Code Linefeed 
CR equ 13 ;ASCII-Code Carriage Return 
EOF equ 26 ;ASCII-Code End of File 
ESC equ 27 ;ASCII-Code Escape 
;== Program starts here ========s=c=s=e===sss=s=ss=ssssss== 
code segment para 'CODE'‘ ;Definition of CODE-Segments 


org 100h 

assume cs:code, ds:code, es:code, ss:code 
;-- Start routine -----------—-~---~-—----~—--—~~-------~--+--------------—--- 
dump label near 


;-- Read in 9 Bytes from Standard input device -------------- 


xor bx,bx ;Standard input has the handle 0 
mov cx,9 ;read in 9 characters 
mov dx,offset newbyte ;Address of the buffer 
mov ah,3Fh 7;Function code for handle reading 
int 21h 7Call DOS-Function 
Or ax,ax ;characters read in? 
jne dodump 7;YES --> process line 
jmp dumpend 7;NO --> DUMPEND 
dodump: mov dx,ax ;record number of characters read 


;-- Fill output buffer with Spaces -------------------------- 


mov cx,15 715 Words (30 Bytes) 

mov ax, 2020h 7;ASCII-Code of " “ to AH and AL 
mov di,offset dumpbuf ;the Address of the output buffer 
cld yincrement on String commands 

rep stosw 7Fill buffer with Spaces 
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s-~ Construct Output Buffer -<-<--<-----— eee e en n ene e nn 


mov cCx,dx ;Get number of characters read in 
mov di,offset dumpbuf+31 ;Position Ascii-Codes in the buffer 
mov bx,offset newbyte ;Pointer to input buffer 

mov si,offset dumpbuf ;Position for Hex-Codes in Buffer 


bytein: mov ah, [bx] 7;Read in Byte 
push si ;store SI on the Stack 
mov si,offset sotab zAddress of special character table 
mov dx,offset sotext-6 ;Address of special character text 
sotest: add dx,6 znext entry in special text 
lodsb ;Load code from special char table 
cmp al,255 ; Reached end of table? 
je noso 7YES --> no special character 
cmp ah,al 7;do codes agree? 
jne sotest 7;NO --> test next table element 
7-- Code was a special character --------------~-----~------— 
push cx 7;Store Counter 
mov si,dx ;copy DX to SI 
lodsb ;read number of char control codes 
mov cl,al ;transfer number of characters to CL 
rep movsb ;copy designation into buffer 
pop cx 7get counter 
pop si ;return SI from Stack 
mov al,ah ;copy character to AL 
jmp short hex s;calculate Hex-Code 
noso: pop si ;return SI from Stack 
mov al,ah ;copy character to AL 
stosb ;store in buffer 
hex: mov al,ah 7;Code of character to AL 
and ah,1111b ;mask upper 4 Bit in AH 
shr al,l ;shift AL right 4 Bits 
shr al,l 
shr al,l 
Sar aly 
or ax, 3030h ;convert AH and AL into ASCII-Codes 
cmp al,"9" zis AL a letter ? 
jbe nobal 7;NO ~-> no correction 
add al,"A"-"1"-9 ;correct AL 
nobal: cmp ah,"9" zis AH a letter ? 
jbe hexout ;NO --> no correction 
add ah, "“A"-"1"-9 ;correct AH 
hexout: mov {[si],ax ;store Hex-Code in buffer 
add si,3 jpoint to next Position 
inc bx ;set pointer to next Byte 
loop bytein ;process next Byte 
mov al,219 ;set separator 
stosb 


mov ax,LF shl 8 + CR ;CR and LF terminate buffer 
stosw ;write in buffer 


;-~- Send Dump to the Standard output device ---------------- 


mov bx,1 ;Standard output is handle 1 

mov cx,di ;determine number of characters to be 
sub cx,offset dumpbuf ;transmitted 

mov dx,offset dumpbuf ;Address of buffer 


mov ah, 40h ;Function code for handle 
int 21h ;call DOS-function 
jmp dump ;read in next 9 Bytes 
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dumpend 


newbyte 
dumpbuf 


sotab 


sotext 


label near 


mov ax,4C00h 
int 21h 


db 9 dup (?) 
db 30 dup (2), 219 
db 49 dup (?) 


db NUL, BEL, BS, TAB 
db LF,CR, EOF, ESC 


db 5,"<BEL>" 
db 4,"<Bs> " 
ab 5 ’ "<TAB> oe 
db 4,"<LF> “ 
db 4,"<CR> " 
db 5,"<EOF>" 
db 5,"<ESC>" 


7;Function number for ending program 
send program with End code 


sthe 9 Bytes read in 
;the output buffer 


;Table of control characters 


;Text of special characters 


; Backspace 
;Tabulator 

; Linefeed 
;Carriage-Return 
7End of File 

; Escape 


7End of CODE-Segment 
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6.11 <Ctrl><Break> and Critical Error Interrupts 


DOS offers two ways of stopping a program during execution. These situations 
occur when the user hits <Ctrl><Break> (<Ctrl><C>), or when a critical error 
occurs during access to an external device (i.e., printer, hard disk, disk drive, etc.). 
Although the key combination varies with the PC configuration, we'll use 
<Ctrl><Break> consistently in this section. 


<Ctrl><Break> 


Pressing <Ctrl><Break> to stop a program during execution can have some 
serious consequences. After the user presses this key combination, DOS abruptly 
takes control from the program without allowing the program to perform any 
“housekeeping” that may be needed. Files are not closed properly, diverted interrupt 
vectors are not reset, and allocated memory is not released. The final result can 
range from a loss of data to a system crash. 


In order to prevent this, DOS calls interrupt 23H. This interrupt is also known as 
the <Ctrl><Break> interrupt. When a program is started, this interrupt points to a 
routine which brings about the end of the program. But a program is free to select 
a routine of its own, thus maintaining control of what occurs when the user 
presses <Ctrl><Break>. | 


However, the interrupt routine doesn't execute immediately. The break flag 
controls when the interrupt routine occurs. This flag can be set at the DOS prompt 
using the BREAK (ON/OFF) command from DOS, or with the help of DOS 
function 33H, sub-function 1. If the break flag is on, every time a function of 
DOS interrupt 21H is called, the keyboard buffer will be checked to see if either 
<Ctrl><Break> or <Ctrl><C> has been pressed. If the break flag is off, this check 
will be made only when calling the DOS functions that access the standard input 
and output devices. 


If this test finds the appropriate key combination, the processor registers are loaded 
with the values contained in the DOS function to be executed. Only after this is 
interrupt 23H called. 


If a program directs this interrupt to a routine of its own, there are several ways to 
react. For example, the program could open a window on the screen which asks if 
the user would like to end the program. It can also decide for itself whether or not 
the program should end. 


Maintenance 


If the program chooses to halt execution, some form of clean-up routine should 
follow. A routine of this type closes all open files, resets any changed interrupt 
pointers, and releases any allocated memory. After this, function 4CH can end the 
program without returning control to the interrupt 23H caller. 
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If <Ctrl><Break> is to be ignored, then the IRET assembly language instruction 
must return control to DOS. The program must then ensure that all processor 
registers contain the same values they had when interrupt 23H was invoked. 
Otherwise, the DOS function that was originally called cannot be completed 
without error. 


Both ways of handling this situation will be demonstrated in an example at the end 
of this section. 


Critical error interrupt 


Unlike the <Ctrl><Break> interrupt, the critical error interrupt call is rarely a 
reaction to something the user does intentionally. It is usually a reaction to an 
error that occurs when accessing an external device, such as a printer, disk drive, or 
hard disk. While the user can correct the error in many cases (e.g., printer not 
turned on), other errors can be caused by hardware failures that require repairs (e.g., 
read error while accessing hard disk). 


To make allowances for the various kinds of errors, the critical error interrupt 
(interrupt 24H) normally points to a DOS routine that displays the following or a 
similar message on the screen and waits for input from the user: 


(A)bort (R)etry (I)gnore (F)ail 


This clears the screen of the program currently under execution. In addition, this 
interrupt doesn't provide a "clean" program end. Like <Ctrl><Break>, the program 
is in a situation where files are not properly closed, allocated memory is not 
released, etc. 


Installing an interrupt handler in a program to replace the DOS handler can help 
here, too. DOS enlists the help of a processor register to pass this handler various 
information when it is called. This helps the interrupt handler locate the source of 
the error. Bit 7 in the AH register indicates either a floppy or hard disk access error 
(bit 7 off), or some other error (bit 7 on). In addition, the BP:SI register pair 
points to the head of the device driver that was being called when the error 
appeared. A detailed error code is contained in the lower 8 bits of the DI register, 
and the contents of the upper 8 bits are undefined. This returns the following error 
codes: 
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Error Codes Passed to the Critical Error Handler 


| Meaning 
Disk is write protected . 
Access to an unknown device 
Drive not ready 
Unknown command 


CRC error 
Wrong data length 


Seek error 

Unknown device type 
Sector not found 
Printer out of paper 
Write error 

Read error 

General error 


When called, the critical error handler can respond by opening a window on the 
screen that asks the user to decide to ignore the error, retry the access, or abort the 
program. The latter option can only instruct the interrupt to call DOS functions 
01H to OCH. This means that the program ends abruptly, similar to pressing 
<Ctrl><Break>. While it is true that calling other DOS functions within the 
handler causes no errors in itself, the return to DOS causes a system crash. Such 
handlers are also not allowed to end a program through the use of DOS function 
4CH. Instead the handler must return to its caller with the help of the IRET 
command. With that, DOS expects a code in the AL register that will show it how 
to react to the error. It interprets the contents of the AL register as follows: 


Output Codes of a Critical Error Handler 
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Ignore the error 
Retry the operation 


End program with Interrupt 23h 
End function called with an 
error {(DOS 3.0 up only) 


The last output code in the above list represents the most sensible reaction to an 
error that can't be fixed by repeating the operation (as in the example where the 
printer needs to be tured on). The receipt of this code invokes the normal ending 
of the function call in which the error occurred. The function then sets the carry 
flag to signal the error. While this makes a "critical" error and a "normal" error 
indistinguishable to the program, it's possible to tell them apart by setting a flag 
within the critical error handler. 


° AHHH EKER K EER EK KEKE KER KEKE KRERER ERE KEKE KEKE EREKEKEKRKEEEEEREKEREEKEKEKE 0 


¢ 

be CE HAND x; 
il xin ss ccm Ses sn i eum um Sih i’ ain ams Gk vw eu) ab Sol un “ele Al ami ao eo ei lin us ‘cm Sus ges ‘ois ~<a acs sein tse Sic: sles eth “Sas i crn eae Gaol Saco ue ain cain ee ees Gis es uss ‘us a “Ss 
= Description : Forms the basic structure of an assembler * 3 
7 program, in which the DOS Ctrl-Break and ** 
al Critical Error Interrupt are captured *; 
3% (nc ‘ae 00m erm A im San nes se ins com ct nn secs dines Si iets ane cn Ge ee selec aime te Ss te esa nbn Gs tnt beam enn cnts ‘ant Gane mtn eee ee ani xm cam ebm Stem séamana crue sum Gu Sumy cm cet‘ ein set's ee _s 
al Author : MICHAEL TISCHER ne 
“> developed on : 9/5/1988 ~ 
rd last update > 4/8/1989 ws 
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cal 


+ + + 


kkhkkkar 


me Sep Se Re Ne 


const 


cr typ 
cr_ mes 
next line 
end mes 
brk_mes 


dat open: 


exit: 


start 


1 : CE_HAND *; 
(please leave the disk drive open so that a bale 
Critical Error occurs.) ~s 
HK KKK IKK KERR KKK KKK KKK KARE KKK KKK KKK KIAKEKRKEKKK KEKE KKK KEKE KKKEE 9 
ants SSS SS SS SS SES SE SS LS SS TS SS LS LL LE SS ES TS LS TS LL LS LS SS SS SS SS LS SS SS SS SS SSS SS SS 
segment para stack 7dGefinition of the stack segment 
dw 256 dup (?) sthe stack is 256 words 
ends rend of the stack segment 
segment para 'DATA' ;definition of the data segment 
db 0 zgoes to 1, if a critical error occurs 


;during access to a peripheral device 
7 (floppy, hard disk, or printer) 
db O yerror number of the critical error 
db "Critical error! (A)bort or (R)etry: $" 
db 13,10,"$" 
db “Program ended normally.$" 
db “Program aborted.$" 


db “A:TEST.DAT",0 ;name of the test file 

ends 7end of the data segment 

segment para '‘CODE' ;definition of the CODE segment 

assume cs:code, ds:data, ss:stack 

proc far 

7-- install both Interrupt Handlers ---~---------------------- 
push cs ;put CS on the stack 

pop ds zand return as DS 

mov ax, 2523h ;fct.no.: set Ctrl-Break Handler 

mov dx,offset cbreak 7;DS:DX now contains the address of H. 

int 21h ;call DOS Interrupt 

mov al,24h ;now set Interrupt 24h 

mov dx,offset cerror 7DS:DX contains the address of the new H. 
int 21h 7call DOS Interrupt 

mov ax,data j;load segment address of the data segment in 
mov ds,ax ;in the DS register 


7—-- you can add your program here 9 ----------—--- 


swe Ma Ne 


7-- for a demonstration, try to open a file ----------------- 
7-- on the opened disk drive nnn ne n- === 


mov ah,3dh ;function number: open file 

mov al,0O ;file mode: read only 

mov dx,offset dat nam ;DS:DX = addresse of the filename 

int 21h 7call DOS Interrupt 21h 

jnc exit 7no error? NO --> END 

cmp cr err,0 ;critical error? 

je exit 7NO --> END 

call crit_err ya critical error occured 

jmp dat open ;CRIT_ERR returns only if the operation 


;should be retried 

; (IGNORE is not possible) 
7-- the handler must not be re-installed before the end ------ 
;-~ of the program, since this is done by DOS = =-=---= 


mov ah,9 ;function number: pass string 

mov dx,offset end mes ;DS:DX = address of the message 

int 21h ;call DOS Interrupt 

mov ax, 4C0O0h ;function no.: end program (ERRCODE=0) 

int 21h 7call DOS Interrupt and end the program 
wwith it 

endp 


;-—- CRIT ERR: called within the program after discovery of a ---------- 


crit_err 


ask: 


eritical error 9790000 et a 
proc near 
7-- Output message and ask for user input -----~-------------- 


mov ah,9Q ;function number: output string 
mov dx,offset cr_mes 7DS:DX = address of the message 
int 21h 7call DOS Interrupt 
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mov ah,l 7;function number: input character 
int 21h 7call DOS Interrupt 
push ax ynote the input 
mov ah,9 ;function number: output string 
mov dx,offset next_line;DS:DX = address of the message 
int 21h 7call DOS Interrupt 
7~- interpret the user's input ------------------------------- 
pop ax jretrieve the input 
cmp al,"A" jabort? 
je end_up 7go to "clean-up" procedure 
cmp al,"“a" pabort? 
je end_up 7go to “clean-up" procedure 
cmp al,"“r" ;retry? 
je crend 7g0o to end of procedure 
cmp al,"“R" ;retry? 
jne ask 7no, ask again 
crend: ret ;return to caller 
crit_err endp 
7-—- END UP: executes a "clean" ending 9 ----------- nnn nr 
end_up proc near 


7-- all.opened files can be closed and the system memory ---- 
7-- allocated by the program can be freed here -——— 


v 
7 
: 
mov ah,9 ;function number: output string 
mov dx,offset brk_mes ;DS:DX = address of the message 
int 21h zcall DOS Interrupt 
mov ax, 4C00h 7end the program normally with the 
int 21h 74Ch function 
end_up endp 
po> CBREAK: Che: new Ctrl-Bréak- Hand er ea aSeae sae 
cbhreak proc far 


7-- all registers altered within this routine (excluding ---- 
;-~- the Flag Register) have to be secured on the stack ---— 


push ds 
mov ax,data ;load the segment address of the 
mov ds,ax ;data segment in the DS-Register 


7-- for example, you can open a window here in which the ----- 
77-~ user is asked if he really wants to end the program ----- 


we Me Me 


jmp goon ;don't end program 

7-- if the user decides to end the program, a routine with --- 
7-- which the program can be ended can be started here ——=— 
jmp end up ;prepare termination of the program 
;-- the program should not be aborted, continue normal ------ 
—-~ execution a 


go on: pop ds jrestore saved register 
iret zback to DOS, where the interrupted 
sfunction is continued normally 
cbreak endp 
7-- CERROR: the new Critical Error Handler ----------------93-<--------- 
cerror proc far 


z-~- each of the registers (SS, SP, DX, ES, DX, CX und BX) ---- 
;-- that was altered within this routine must be saved -——— 
77- on the stack === 
sti z;allow interrupts again 

push ds 
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mov ax,data ;load segment address of the data segment 
mov ds,ax yin the DS-Register 
mov cr _err,1 ;point to critical error 
mov ax,di yerror number to AX 
mov cr _typ,al ;note error number 
mov al,3 zend function call with error 
pop ds ;fetch DS again 
iret 
cerror endp 
ara ta oe ae a ee ce ee eee eae eee maies 
code ends rend of the code segment 
end start ;start program execution with 


zsthe START vrocedure 
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6. 12 DOS Device Drivers 


A device driver is the part of the operating system responsible for the control of, 
and the communication with, the hardware. It represents the lowest level of an 
operating system, and permits all other levels to work independent of hardware. 
When adapting an operating system to various computers, this is an advantage. 
The entire operating system doesn't have to be changed, only the various device 
drivers. 


In earlier operating systems, device drivers resided in the operating system code. 
This meant that changes or upgrades of these routines to match new hardware were 
very difficult, if not impossible. DOS Version 2.0 introduced a flexible concept of 
device drivers. This makes it possible for the user to adapt even the most exotic — 
PC clone to DOS. 


Custom drivers 


Drivers 


Since communication between DOS and a device driver is based on relatively 
simple function calls and data structures, the assembly language programmer can 
develop a device driver to adapt DOS to any device. Unfortunately, device drivers 
cannot be programmed in a higher level language. 


When developing the code for a driver, the same rules are observed as for 
developing a COM program (no direct segment access). The difference is that a 
device driver starts at offset address OH, and not at 100H. The end of this section 
explains the assembly language implementation in detail. 


During the DOS boot process, the drivers NUL, CON, AUX, PRN and the drivers 
for the disk drives and hard drive (if needed) are loaded and installed. They are 
arranged sequentially in memory and connected to each other. If the user wants to 
install his own driver, he has to inform DOS using the CONFIG.SYS file. This 
text file contains the information which DOS requires for configuring the system. 
Contents of the CONFIG.SYS file are read and evaluated during the boot process 
after linking the standard drivers. If DOS finds the DEVICE= command, it knows 
that a new driver should be included. The name of the driver and perhaps a device 
and path designation are indicated after the equal sign. 


ANSI.SYS 
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The following command sequence includes the ANSI.SYS driver, which is 
supplied with DOS. This driver makes enhanced character output and keyboard 
functions available: 


DEVICE=ANSI.SYS 
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The new driver is added to the chain immediately following the NUL device driver 
(the first driver in the chain). The ANSI.SYS driver replaces the default CON 
driver. To ensure that all function calls for monitor or keyboard communication 
operate through ANSI.SYS, the ANSI.SYS driver is placed first in the device 
group, and the CON driver is moved farther down the chain of devices. Since the 
operating system moves from link to link during the search, it finds the new CON 
driver (ANSI.SYS) first and uses it. Therefore, the system ignores the old CON 
driver as seen in the illustration below: 


NUL 
[Code | 
| Data | 


CON 
| Data 


PRN 


After adding 
new CON 
driver 


Before adding 
new CON 
driver 


Data | 
NUL 
Data | 
CON 
| Data | 
PRN 


"Data | | Data | 


AUX 
| Data | 
elerer 


[Data 
CON 


AUX 
Data 


CLOCK 


sesseJppe Aiowew BulseeJou| 


The driver chain 


ASSIGN 


Not all drivers can be replaced with new ones. The NUL driver is always the first 
driver in the chain. If you add a new NUL driver, the system ignores the new driver 
and continues accessing the original NUL driver. This also applies to the drivers 
for floppy disk drives and hard drives. The reason for this is that disk drives have 
drive specifiers instead of names such as CON (e.g., A:). A new disk drive can be 
added to the system, but since DOS may assign it the name D:, it may not be 
addressed by all programs which want to access device A:. This problem can be 
avoided by redirecting all device accesses using DOS's ASSIGN command. You 
can make the ASSIGN command part of the AUTOEXEC.BAT file. It executes 
after adding drivers and executing the CONFIG.SYS file. To redirect all accesses 
from drive A: (the first disk drive) to device D: (in this case, a new driver for a new 
disk drive), the AUTOEXEC.BAT file must contain the following command 
sequence: 
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6.12.1 


ASSIGN A=D 


The drivers for mass storage devices and the drivers such as PRN are handled 
differently. DOS has two kinds of device drivers: 


° Character device drivers 
° Block device drivers 


Character device drivers communicate with the keyboard, screen, printer and other 
hardware on a character by character (byte by byte) basis. Block device drivers can 
transmit an entire series of characters during each function call (disks, hard disks, 
etc.). The two driver groups differ somewhat through the ways each supports 
different functions. 


Character Device Drivers 


Let's start with character device drivers because their structure is simpler than block 


device drivers. Character device drivers transmit one byte for every function call. 
They communicate with devices such as the keyboard, display, printer and modem. 
A device driver can service only one device. Therefore, individual drivers for 
keyboard, display, printer, etc., exist in DOS after booting. 


Character devices can operate in either cooked mode or raw mode. 


Cooked mode 


In cooked mode, the device driver reads characters from the device and performs a 
test for certain control characters. DOS then passes the character to an internal 
buffer. DOS also checks to determine whether any <Enter>, <Ctrl><P>, 
<Ctrl><S> or <Ctrl><C> characters exist. If the system detects the <Enter> 
character, it ignores any further input from the device driver, even if the specified 
number of characters has not yet been read. Then the characters read are copied from 
the internal buffer to the buffer of the calling program. If characters are output in 
cooked mode, DOS tests for <Ctrl><C> or <Ctrl><Break>. If one of these 
combinations is detected, the currently running program stops. Pressing 
<Ctrl><S> temporarily stops the program until the user presses any other key. 
<Ctrl><P> redirects the output from the screen to the printer (PRN). Pressing 
<Ctrl><P> a second time redirects the output from the printer back to the screen. 


Raw mode 
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In raw mode, the device driver reads all characters without testing. If a program 
wants to read in 10 characters, it reads exactly 10 characters, even if the user 
presses the <Enter> key as the second character of the string. Raw mode transmits 
the characters direct to the calling program's buffer, instead of using an internal 
DOS buffer. During character output, raw mode doesn't test for <Ctrl><C> or 
<Ctrl><Break>. 
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DOS function 44H of interrupt 21H defines the mode of the character device driver 
(see the end of this section for a detailed description of this interrupt). 


Block Device Drivers 


A block device driver normally communicates with mass storage devices such as 
floppy or hard disks, or high speed cassette tapes. For this reason, they 
simultaneously transmit a number of characters which are designated as a block. In 
some cases, a single call to a function transmits several blocks of data. The sizes 
of these blocks can differ from one mass storage device to another, as well as 
within one particular mass storage device. 


How block device drivers work 


Access 


6.12.3 


Unlike character device drivers, a block device driver can control several devices at 
the same time. You can even divide one device into several logical units. For 
example, a 40 megabyte hard disk can be divided into two 20 megabyte hard disks 
with the names C and D. These logical devices have single-letter specifiers instead 
of device names or filenames. The device designation depends on its position in the 
chain of device drivers. If a device driver supports several logical devices, single 
letters can be used as specifiers in sequential order. This is why the example above 
lists two logical drives named C and D instead of C and F. 


Every one of these devices must have a file allocation table (FAT) and a root 
directory. Block device drivers make no distinction between cooked and raw modes. 
They always read and write the exact number of blocks unless an error is detected. 


There are several ways to access a device driver. Character device drivers are 
accessed using the normal FCB or handle functions by simply indicating the name 
of a driver (e.g., CON: instead of a filename). A block device driver is accessed 
using the normal DOS functions (file, directory, etc.) by using the drive designator 
assigned by DOS during the boot process. 


Functions 1H through CH of interrupt 21H invoke read and write operations in a 
device driver. Two other options exist for accessing device drivers. These will be 
discussed shortly. 


Structure of a Device Driver 


Even though the two types of device drivers differ in some important details, they 
do have similar structures. Each has a device header, a strategy routine and an 
interrupt routine (a different kind of interrupt from the ones you've read about up 
until now). 
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Device header 
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The device header appears at the beginning of each device driver and contains 
information needed by DOS for implementing the driver. 


The first two fields are the link to the next driver (offset and segment address) in 
the chain of device drivers. The memory locations required for these link fields 
must be reserved by the programmer, but DOS fills in when the driver is installed 
in the system. The next field of the device header is the attribute word. The 
attribute word describes the device driver and tells DOS, among other things, if it 
is a block or character device driver. 


+ OOH | () sqqre o nex TOYO 
Seament address of next driver 1 word 
Device attribute 1 word 
Offset address of strategy routine 1 word 
Offset address of interrupt routine (1 word) 


+ OAH Driver name from character driver (8 bytes) 
or number of devices used by block driver 


Device driver header 


PC System Programming 
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Structure of the device attribute 


Only bits 11 through 15 are used by a block driver. The IOCTL bit tells DOS if 
this driver supports the IOCTL function of DOS. The end of this chapter and the 
descriptions of functions 3 and 12 describe this function in greater detail. Bit 11 
first appears in DOS Version 3 and should be 0 in earlier versions. A block driver 
indicates whether a medium change is recognized on the device supported (e.g., a 
floppy disk drive). If the bit is set, the driver must support a few additional 
functions. 


The next two fields contain the offset address of the strategy routine and interrupt 
routine. The last field contains the name of the device driver if it is a character 
device driver. If the name is less than eight characters in length, blank spaces 
(ASCII code 32) pad the remaining characters. If it is a block device driver, the first 
byte of this field contains the number of logical devices supported by the driver. 
The remaining seven bytes of this field remain unused and contain the value 0. 


Strategy routine 


DOS calls the strategy routine first to initialize the driver, then repeatedly before 
each subsequent I/O request from the driver's interrupt routine. The address of a data 
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Status 
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structure which contains information about the operation to be performed (the 
request header) is passed by DOS to the strategy routine in register pair ES:BX. 
The double word pointer to the data block is stored, and control immediately 
returns to DOS. DOS then calls the interrupt routine of the driver to perform the 
actual operation. | 


The request header, whose address is passed to the strategy routine, always contains 
at least 13 bytes and contains information which tells the driver how to perform 
the upcoming operation. Depending on the operations performed, further 
information can be added to the end of the request header which differs depending on 


the operation. 
RAM 


Data block length in bytes (1 word) 
Device number in communication {1 word) 
Command code (1 word) 


Reserved | (8 bytes 


Media descriptor (1 byte) | 
Buffer offset address (1 word) 
Buffer segment address (1 word) 
Number | (1 word) 


+ 14H | Starting sector (8 bytes 


— 


Structure of the request header 


DOS calls the interrupt routine immediately after calling the strategy routine. Its 
first task is to save the processor registers that will have their contents changed by 
the various functions of the driver to the stack. Then it obtains the command code 
from field 3 of the request header and calls the appropriate command code routine. 
After executing the routine, it fills in the status field of the request header and 
restores the processor registers from the stack. As a last step it returns control to 
the calling DOS function. 


field 


The value of the status field specifies whether the function executed without error, 
or if an error occurred during execution. For this reason, every driver function must 
set the DONE bit (bit 8) in the status field. This DONE bit must be set even if the 
function is a dummy (non-performing) function. 
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15 14 13°12 11:10 9 8 7 6 5 4 3 2 1 ~~ 09 Pit 


0O=OK 
1=error 


Error code when bit 15=1: 


O=medium write protected 
1=unknown device 
2=drive not ready 
3=unknown command 
4=read (CRC-) error 
5=parameter data block 
has a false length 
6=search error 
=unknown medium 
8=sector not found 
9=printer out of paper 
10=write error 

11=read error 
12=common error 
13=illegal medium change 


Status field error codes 


6.12.4 Device Driver Functions 


Under DOS Version 2, any installable device driver must support 13 functions, 
numbered from 0 to 12, even if their only action consists of setting the DONE 
flag in the status word. DOS Versions 3 and 4 include four additional functions 
which can be supported, but are not required. Some of these functions concern one 
of the two driver types, while others apply to both driver types (e.g., 
initialization). Unused functions must at least set the DONE flag of the status 
word. Let's look at the various functions in detail according to their function 
numbers. 


Request header 


Every function described here receives its arguments from the request header (whose 
address is passed by DOS to the strategy routine) and stores its "results" in the 
request header. For this reason, the offset address to the arguments, relative to the 
beginning of the request header, is passed to the specified function. These 
arguments are later transferred to variables. Besides this offset address, a flag 
indicates whether this information consists of a byte, word or PTR. The PTR data 
type represents a pointer to a buffer and consists of two adjacent words. The first 
word is the offset address of the buffer. The second word is the segment address of 
the buffer. 
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Function 0: Driver Initialization 


DOS calls this function during the system boot procedure to initialize the device 
driver. This function can involve hardware initialization, setting various internal 
variables to their default values, or the redirection of interrupts. Since the entire 
operating system has not been completely initialized at this point, the 
initialization routine can only call functions 1 through OCH and 30H of DOS 
interrupt 21H. These functions can be used to determine the DOS version number 
and to display a driver identification message on the screen. Even if the newly 
linked driver is a CON driver, the output to the display occurs through the old 
CON driver, because there are no new drivers linked into the system after 
completion of the initialization routine. 


Initialization and the request header 


The initialization routine can obtain two pieces of information from the request 
header. The first item is the memory address containing the text following the 
equal sign on the line in the CONFIG.SYS file that loaded the driver into the 
system. 


A typical line in a CONFIG.SYS file can look like this: 


DEVICE=ANSI.SYS 


In this case, the device name is ANSI.SYS, which assigns the standard ANSI 
escape sequences for screen control to the PC. The memory address passed to the 
initialization routine points to the character following the equal sign (in this case, 
the A of ANSI.SYS). This makes it possible to store additional information 
following the name of the device driver. This information is ignored by DOS, but 
can be read by other routines. 


Logical device designation 
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The second item is only available under DOS Version 3.0 and higher, and only if 
the driver is a block device driver. This is the letter designation of the first logical 
device of the driver. The value 0 stands for A, 1 for B, 2 for C, and so on. 


The initialization routine must return four parameters to the calling DOS function. 
The first parameter is the status of the function, i.e., the indication of whether the 
function has executed correctly. For a block device driver, the number of logical 
devices supported must also be passed. This information could also be obtained 
from the device driver's header, but is ignored by DOS. 
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The next parameter that the device driver must pass to DOS is the highest memory 
address which it occupies or uses. This lets DOS know where the next device 
driver can be installed. 


BPB 


If the driver is a block device driver, the last argument passed must be the address 
of an array which contains an entry for every logical device. This array contains the 
addresses of BIOS parameter blocks (BPBs). The address is passed as two words, 
the first word contains the offset, and the second word contains the segment address 
of the array. The first two words within this table are the address for the first 
logical device supported. The next two words indicate the address for the second 
logical device, etc. The BPB, described in detail in Section 6.12, is a data block 
containing information which describes a logical device. If all or some of the 
logical devices have the same format, all entries in the BPB address table can point 
to a single BPB. 


Bytes per sector (1 word) 
+ 02H Sectors per cluster (1 byte) 


+ 03H Reserved sectors (including boot sectors) (1 word) 


Number of sectors per FAT (1 word) 


BIOS Parameter Block design 


F8H = hard disk 
F9H = 


5.25" diskette, double-sided, 15 sectors per track 
5.25" diskette, single-sided, 9 sectors per track 
5.25" diskette, double-sided, 9 sectors per track 


5.25" diskette, single-sided, 8 sectors per track 


5.25" diskette, double-sided, 8 sectors per track 


Media descriptor byte 
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Calling parameters of function 0: 


Function number (0 


Address of character that follows the equal sign after the 
DEVICE command in the CONFIG.SYS file 


Offset 22 (byte) | Device number of the first device supported by the driver 
(O=A, 1=B...) (applies to block device drivers from DOS 
Version 3.0 up onl 


Returned parameters of function 0: 


Offset 3 (word 


Offset 13 (byte) | Number of devices supported (block devices onl 


Offset 14 (ptr) | Address of first available memory location following the 
driver 

Offset 18 (ptr) | Address of array containing the addresses of BPB (block 
devices onl | 


Function 1: Media Check 
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This function is used only with a block device driver. A character device driver 
should merely set the DONE flag of the status word and exit. This function is used 
by DOS to determine whether the media (diskette) has changed. It is often used 
when examining a disk directory. If the disk medium was not changed since the 
last access, DOS still has this information in memory, otherwise DOS must reread 
the information from the media which delays the execution of the current task. 


In some cases, as with floppy disks, the answer to the question is fairly 
complicated. For this reason DOS permits function 1 to answer not only with 
"yes" and "no", but also with "don't know.” In any case, the answer affects further 
DOS activity. 


If the media is unchanged, access to the media can take place immediately. If the 
media was changed, however, DOS closes all internal buffers related to the current 
logical device. This causes the loss of all data which should have been transmitted 
to the media. Then it calls function 2 of the current device driver, loads the FAT 
and the root directory. If the media check function answers with "don't know,” the 
additional steps taken by DOS depend on the status of the internal buffers related to 
the current logical device. If these internal buffers are empty, DOS assumes that 
the media was changed and acts as if function 1 answered "yes." If the buffers 
contain data which should have been transmitted to the media, DOS assumes that 
the media is intact and writes the data. If the media was indeed changed, the data 
written to a changed media may damage the new diskette's file structure. 


Since subsequent processing depends on the response from the media check 
function, the driver should handle the response carefully. Before enabling the 
mechanism used by the function to respond, the function examines the parameters 
passed to it. If the driver supports several logical devices, the first parameter is the 
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number of devices. Next is a media descriptor code. This code contains information 
about the type of media last used in the current logical device. Only devices which 
can handle several different formats can use this task. For example, AT disk drives 
which can use both 360K and 1.2 megabyte diskette formats. 


If the media check function determines that the medium in a device is non- 
removable (e.g., a fixed disk), it can always respond "not changed". If, on the other 
hand the device media can be changed (e.g., a disk), the correct response can only 
be determined by fairly complex procedures. If these procedures are not used, the 
response should be "don't know”. 


For the sake of completeness, here are the three procedures which provide fairly 
accurate results. 


Since a device with changeable media has an opening and closing mechanism, the 
function should check to determine whether the media was removed. However, it 
cannot determine if the removed media is identical to the newly inserted medium. 


If the media has a name, the function should read this name to determine whether 
the media was changed. This procedure only makes sense if every media has a 
unique name. 


The disk drive procedure used by DOS hinges on the fact that changing medium 
takes some time. DOS assumes that even a user that can move fast needs about 
two seconds to remove a diskette from a drive and insert a new diskette in the same 
drive. If two consecutive diskette accesses occur less than two seconds apart, DOS 
assumes that no diskette change occurred. 


A byte in the data block is used to indicate changes. The value -1 (FFH) means 
"changed", 0 means "don't know" and 1 means "not changed”. 


If the media was changed, the device driver signals a media change (bit 11 in the 
device attribute = 1), the address of a buffer must be passed to DOS Version 3 and 
newer, which contains the volume name of the previous media. This name must 
be stored there as an ASCII string and terminated with an end character (ASCII 
code 0). 
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Address of buffer containing the previous volume name 
only if device indicates a media change 


Function 2: Bulld BIOS Parameter Block (BPB) 


This function is used only by block device drivers. A character device driver should 
just set the DONE flag of the status word and exit. DOS calls this function when 
the media check function determines that the media was changed. This function 
returns a pointer to a new BPB for the media. 


As you can see by the layout of the calling parameters, the device number media 
descriptor and a pointer to a buffer are passed to this function by DOS. If the 
device is a standard format (bit 13 of the device attribute =0), then the buffer 
contains the first sector of the FAT. 


Calling parameters of function 2: _ | | __ 


Returned parameters of function 2: 


\Offset 3(word) | Statusword 
Offset 18 (ptr) _| Address of the BPB of addressed device _ | 


Function 3: I/O Control Read 
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This function passes control information from the character or block device driver 
to the application program. It can only be called through function 44H of interrupt 
21H if the IOCTL bit in the device attribute word in the device driver header is set. 
Different parameters are passed to the function, depending on whether the driver is 
a character or a block device driver. 


A character device driver is passed the number of characters to be transferred and the 
address of a buffer for the transfer of the data. 


A block device driver is passed the device number, the media descriptor byte, the 
address of the buffer to be used for the data transfer, the pointer to the first sector to 
be read and the number of sectors to be read. 
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Offset 13 (t 
8 


Media descriptor byte (block devices onl 
Offset 14 (ptr Address of buffer into which data should be transmitted 


Offset 18 (word)| Number of sectors to be read (block device) or 
Number of characters to be read (character device 


Offset 20 (word)} First sector to be read (block devices onl 


Returned parameters of function 3: 
Offset 3 (word 


Offset 18 (word)| Number of sectors read (block device) 
Number of characters read (character device 


Function 4: Read 


This function reads data from the device to a buffer specified in the calling 
parameter. Should an error occur reading the data, the error status must be set. 
Additionally the function must report the number of sectors or bytes read 
successfully. Simply reporting an error is not good enough. 


Number of characters to be read (character device 


Offset 20 (word)} First sector to be read (block device onl 


Returned parameters of function 4: 
Offset 3 (word 


Number of characters read (character device 
and higher 


Function 5: Non-destructive Read 


This function is used by a character device driver to test for unread characters in the 
input buffer. A block device should set the DONE flag of the status word and exit. 


DOS tests for additional characters using this function. If more characters exist, the 
busy bit must be cleared (set to 0) and the next character passed to DOS. The 
character that is passed remains in the buffer so that a subsequent call to a read 
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function will return this same character. If no additional characters exist, the busy 
bit must be set (set to 1). 


Calling parameter of function 5: 7 | 


Returned parameters of function 5: | 7 | = 
| Offset 3 (word 
Offset 13 (byte) | Thecharacterread 


Function 6: Input Status 


This function is used to determine if a character is waiting to be read from the 
input buffer of a character device. A block device driver should set the DONE flag 
of the status word and exit. 


If a character is waiting to be read from the input buffer, the busy bit is cleared (set 
to 0). If a character is not in the input buffer, the busy bit is set (set to 1). 


When a character is waiting to be read, the Input Status function (06H) resets the 
status word busy bit to 0 and returns the character to DOS. The character is not 
removed from the buffer and is therefore non-destructive. This function is 
equivalent to a one-character look ahead. 


Calling parameter of function 6: | | | 


Returned parameters of function 6: E 7 | 


Offset 3 (word) | Status word: Characters already in buffer = 0; Read request to} 
physical device = 1 : 


Function 7: Flush Input Buffers 
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This function clears the internal input buffers of a character device driver. Any 
characters read but not yet passed to DOS are lost when this function is used. A 
block device driver should set the DONE flag of the status word and exit. 


Calling parameter of function 7: 
Offset 2 (byte 


Returned parameter of function 7: — 
Offset 3 (word 
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Function 8: Write 


This function transfers characters from a buffer to the current device. If an error 
occurs during transmission, the status word is used to indicate this error. Both 
block and character devices use this function. 


The parameters used for this function depend on whether the driver is for a character 
or block device. Both pass a buffer address from which a certain number of 
characters should be transferred. A character device driver is passed the number of 
bytes to be transferred in addition to this information. 


A block driver is passed the number of sectors to transfer (not the number of 
characters), the number of the device to be addressed, its media descriptor and the 
address of the first sector on the medium. 


Should an error occur writing the data, the error status must be set. Additionally 
the function must report the number of sectors or bytes written successfully. 
Simply reporting an error is not good enough. 


Calling parameters of function 8: 
[Offset 14 (ptr)_| Address of the buffercontainngdata9 
| Offset 18 (word)| Number of sectors to be written (block device) 

| Number of characters to be written (character device 

first sector to be written (block device onl 


Returned parameters of function 8: 
Offset 3 (word 


Offset 18 (word)| Number of sectors written (block device) 
Number of characters written (character device | 
Offset 22 (ptr) | Pointer to volume ID on return of error OFH (Version 3.0 
up 


Function 9: Write with Verify 


This function is similar to function 8, but with the difference that the characters 
written are reread and verified. 


Some devices, especially character devices such as a monitor or a printer, do not 


require verification since either no errors occur during transmission (monitor) or 
the data cannot be verified (printer). 
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Device number (block drivers onl 
Offset 14 (ptr Address of the buffer containing data 
Offset 18 (word)| Number of sectors to be written (block device) 
Number of characters to be written (character device 
First sector to be written (block device onl 


Returned parameters of function 9: 


Number of characters written (character device 
up 


Function 10: Output Status 


This function indicates whether the last write operation to a character device is 
completed or not. A block device should set the DONE flag in the status word and 
exit. 


If the last write operation is complete then the busy bit of the status word is 
cleared; otherwise the busy bit is set to 1. 


Calling parameter of function 10: 


Function number (10 


Returned parameter of function 10: | 
Offset 3 (word) | Status word: The busy bit is 1 if the last character output 
has not been completed 
Function 11: Flush Output Buffers 
This function completely clears the output buffer even if it contains characters 


waiting for output. A block device should set the DONE flag on the status word 
and exit. 


Calling parameter of function 11: __ 
Offset 2 (byte) | Function number (11 


Returned parameter of function 11: 
Offset 3 (word 
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Function 12: /O Control Write 


This function passes control information from the application program to the 
character or block device driver. It can only be called through function 44H of 
interrupt 21H provided the IOCTL bit in the device attribute word in the device 
driver header is set. Different parameters are passed to the function, depending on 
whether the driver is a character or a block device driver. 


A character device driver is passed the number of characters to be written and the 
address of the buffer from which these characters are transferred. 


A block device driver is passed the device number (in case the driver services 
logical devices), the media descriptor byte, the address of the buffer from which the 
data is to be written, the number of the first sector to be written and the number of 
sectors to be written. 


A character device driver returns the number of bytes written. A block device driver 
returns the number of sectors written. 


Calling parameters of function 12: 

Device number (block device onl 

Function number (12 

Media descriptor of addressed device (block device onl 

Address of buffer from which data should be read 

Offset 18 (word)| Number of sectors to be written (block device) 
Number of characters to be written (character device 

First sector to be written (block device onl 


Returned parameters of function 12: 
Offset 3 (word) | Status word 


Offset 18 (word)| Number of sectors written (block device) 
Number of characters written (character device 


The following four functions are supported by DOS version 3.0 and higher. 


Function 13: Open 


This function can be used only if the OCR (Open/Close/RM) bit in the device 
attribute word in the device driver header is set. Its task differs, depending whether 
it is a character or block driver. 


A block driver uses this function every time a file is opened. This function 
determines how many open files exist on this device. Use this command carefully, 
since programs which access FCB function calls tend not to close open files. This 
problem can be avoided by assuming during every media change that no files 


165 


6. The Disk Operating System PC System Programming 


remain open. For devices with non-changeable media (e.g., a hard disk) even this 
procedure may not help. 


Within a character driver, this function can send an initialization string to the 
device before transmitting the data. This is an advantage when used for 
communication with the printer. The initialization string should not be included in 
the driver, but can be called, for example, with the IOCTL function of interrupt 
21H, which calls function 12 of a driver to transmit it from an application 
program to the driver. The function can also be useful because it can prevent two 
processes (in a network or in multiprocessing) from both accessing the same 
device. 


For the devices CON, PRN and AUX, this function is not called since they are 
always open. 


Calling parameters of function 13: 
Device number (block device onl kt 
Function number (13 St. 


Returned parameter of function 13: | | 


Function 14: Device Close 
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This function is the opposite of function 13. This function can only be addressed if 
the OCR bit in the device attribute word of the device driver header is set. Its task 
differs, depending whether it is a character or block driver. 


A block driver calls it after closing a file. This can be used to decrement a count of 
open files. Once all files on a device are closed the driver should flush the buffers 
on removable media devices, because it is likely that the user is about to remove 
the media. 


A character driver can use this function to send some closing control information 
to a device after completing output. For a printer this could be a formfeed. As in 
function 13, the string could be transmitted from an application program using the 
IOCTL function. 


Calling parameters of function 14: 
Device number (block device onl 
Function number (14 


Returned parameter of function 14: | 
Offset 3 (word 
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Function 15: Removable Media 


This function indicates if the media in a block device can be changed or not. This 
function is used only if the OCR bit in the device attribute word of the device 
driver is set. A character device driver should set the DONE flag in the status word 
and exit. 


If the media can be removed, the busy bit is cleared; otherwise it is set to 1. 


Calling parameters of function 15: 
Device number (block device onl 
Function number (15 


Returned parameter of function 15: 


Offset 3 (word) | Status word: If the media can be removed, the busy bit must 
contain the value 0 


Function 16: Output until Busy 


This function transfers data from a buffer to an output device until the device is 
busy (i.e., can no longer accept more characters). As this function is supported by 
character devices, a block device driver should set the DONE flag on the status 
word and exit. 


This function works particularly well with print spoolers, through which files can 
be sent to a printer as a background activity while a program executes in the 
foreground. It is possible that not all of the characters in the transfer request will 
be sent to a device during this function call. This is usually not an error, it could 
be the result of the device becoming busy. The function is passed the number of 
characters to be transmitted as well as the buffer address. If the output device 
indicates during transmission that it can no longer accept additional characters, it 
indicates the number of characters successfully transferred and returns control to the 
device driver. 


Offset 2 (byte)_| Function number (16) 
Offset 14 (ptr 
Offset 18 (word 
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6.12.5 


Clocks 


arameters of function 16: 


Status word 


Offset 18 (word)| Number of characters written _ 


Clock Driver 


The clock driver is a character device driver whose only function is to pass the date 
and time from DOS to an application. The clock driver can also have a different 
name, since DOS identifies it by the fact that bit 2 in the device attribute word of 
the device driver header is set to 1, instead of by name. Bit 15 must also be set 
since the clock driver is a character device driver. Functions 2AH to 2DH of DOS 
interrupt 21H read the date and time and call the driver. A clock driver must 
support only functions 4, 8 and 0 (initialization). During the call of function 4 
(reading), the date and time pass from the driver to DOS. DOS can set a new date 
and time with function 8. Both functions have the time and date passed in a buffer 
of 6 bytes in length. 


Crome [aiowtes SSS ee | 


: 


10000: 0000 


Passing date and time to a clock driver 


The date format is unusual. Instead of passing the month, day and year separately, 
DOS passes the number of days elapsed since January 1, 1980 as a 16-bit number. 
A fairly complex formula converts this number into normal date format, taking 


leap years into account. The clock driver normally uses function 0 and 1 of the 


BIOS interrupt 1AH to read and set the time. 
on AT models 


AT and AT-compatible computers have a battery powered realtime clock. 
Functions 0 and 1 of interrupt 1AH use a software controlled time counter and not 
the battery powered realtime clock. When the computer is rebooted, the date and 
time previously set with driver function 8 is cleared. You can use the clock driver 


_ to access the realtime clock using functions 2 and 5 of interrupt 1AH instead of 
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function 0 and 1. 
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6.12.6 Device Driver Calls from DOS 


Open 


Block 


Now that you have some familiarity with the functions of the different device 
drivers, you can look toward developing your own personal device driver. Here are 
the steps which take place before and after calling a device driver function. 


A chain of events begins when a DOS function which handles input and output is 
called using interrupt 21H. Calling one of these functions can in tum call a series 
of other functions and corresponding read and write operations. 


One example of this is when the Open function 3DH is called to open a file in a 
subdirectory. First of all, before it can be opened, DOS must find the file. This 
may require the searching of a set of directories instead of just reading in the FAT. 
During each access of interrupt 21H, DOS determines which of the available device 
drivers should be used to read or write characters. When this happens, DOS sets 
aside an area in memory to store the information required by the device driver. 


For files, DOS must convert the number of records to be processed into logical 
sector numbers. DOS then calls the strategy routine of the device driver, to which 
it passes the address of the newly created data block (request header). Then the 
interrupt routine of the driver is called, which stores all registers. It isolates the 
function code of the requested function from the data block and starts to process the 
function. 


If the addressed driver is a character device driver, the function only has to send the 
characters to the hardware or request the characters to be read. 


devices 


For a block device (e.g., a mass storage device such as a floppy or hard disk) the 
logical sector number must be converted into a physical address before a read or 
write access. The logical sector number is broken down into a head, track and 
physical sector number. 


After the read or write operation ends, the driver function must place a result code 
in the status field of the request header to be returned to the calling DOS function. 
Next the contents of all registers are restored and control is returned to the calling 
DOS function, which, depending on the result of the driver function, sets or resets 
the carry flag and places any error code into the AX register. The interrupt function 
then returns control to the routine which called interrupt 21H. 
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6.12.7 Direct Device Driver Access: IOCTL 


Here we discuss IOCTL in detail, since it offers an alternate method of 
communicating with the device driver. You can only use these functions if the 
IOCTL bit of the device attribute is set. 


The IOCTL function itself is one of many functions addressable from DOS 
interrupt 21H. Its function number is 44H. Three groups of sub-functions are 
accessible: 


° Device configuration 
e Data transmission 
8 Driver status 


The number of the desired sub-function is passed to the IOCTL function in the AL 
register. After the function call, the carry flag indicates whether the function 
executed correctly. A set carry flag indicates the occurrence of an error and the error 
code can be found in the AX register. 


Character device driver status 
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The number of the desired sub-function is passed to the IOCTL function in the AL 
register. After the function call, the carry flag indicates whether the function 
executed correctly. A set carry flag indicates the occurrence of an error and the error 
code can be found in the AX register. 


Sub-functions 6 and 7 can determine the status of a character device driver. Sub- 
function 6 can determine if the device is able to receive data. Sub-function 7 can 
determine if the device can send data. The handle of this device is passed in the BX 
register. 


If the device is ready, both functions 6 and 7 return the value FFH in the AL 
register. 


Sub-function 2 reads control data from the character device driver. The handle is 
passed in the BX register and the number of bytes to be read is passed in the CX 
register. In addition, the DS:DX register pair contain the address of the buffer into 
which the data will be read. If the carry flag is clear, then the function was 
successful and the AX register contains the number of characters read. If the carry 
flag is set, then there was an error and the AX register contains the error code. 


Sub-function 3 writes control information from a buffer to the character device 
driver. Again, the handle is passed in the BX register, the number of bytes to be 
written in the CX register and the address of the buffer in the DS:DX register pair. 
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The return codes are the same as for sub-function 2. These two sub-functions are 
used to pass information between the application program and the device driver. 


Block device driver status 


Sub-functions 4 and 5 have the same task as sub-functions 2 and 3. However, they 
are used for block devices and not character devices. Instead of passing the handle in 
register BX, you pass the drive code (0=A, 1=B, etc.) in the BL register. 


Sub-function 0 is used to get device information for a specified handle. The sub- 
function number is passed in the AL register and the handle in the BX register. The 
function returns the device information word in the DX register. 


For block devices: 


bits 8-15 = reserved 
bit 7 = 0 if a block device 
bit 6 = 0 if file has been written 
1 if file has not been written 
bits 0-5 = drive code (0=A, B=1, etc.) 


For character devices: 


bit 15 = reserved 

bit 14 = 1 if device supports IOCTL sub-functions 
0 if device does not support IOCTL sub- 
functions 

bits 8-13 = reserved 

bit 7 = if a character device 

bit 6 - 0 if end of file for input device 

bit 5 = 0 if cooked mode 
1 if raw mode 

bit 4 = reserved 

bit 3 = 1 if clock device 

bit 2 = 1 if NUL device 

bit 1 = 1 if standard output device 

bit 0 = 1 if standard input device 


Cooked and raw modes 


Sub-function 1 is used to set device information for a specified handle. This sub- 
function is often used to set the standard input device from cooked mode to raw 
mode or back. 


Two final interrupts are sometimes used by block device drivers. These two 
interrupts, 25H and 26H are used to read from and write to the disk drive. You can 
use these interrupts, for example, to process disks that were formatted using a 
"foreign" operating system. 
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6.12.8 


6.12.9 
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The device number is passed in the AL register, the number of sectors to be 
transferred is passed in the CX register, the starting sector number to be transferred 
is passed in the DX register and the buffer is passed in the DS:BX register. The 
carry flag is clear if there was no errors. If the carry flag is set, then the error code 
is returned in the AX register. 


Tips on Developing Device Drivers 


Major headaches in developing a device driver occur because of problems that arise 
during the testing phases of a new driver. First, a device driver must load into a 
memory location assigned to it by DOS, at an address unknown to the 
programmer. Second, a newly developed CON driver can't be tested using the 
DEBUG program, since DEBUG uses this driver for character input and output. 


We recommend that after you write the actual driver, you write a short test 
program that calls the individual functions in the same manner as DOS, but 
without having the driver installed as part of DOS. The advantages to this are that 
everything executes under user control, and the whole process can be corrected with 
a debugger. In any case, a new device driver (especially a block device driver) 
should only be linked into the system after it has been tested completely and has 
been proven to be error-free. 


Note: When working with a hard disk, prepare a floppy system diskette 
before test booting the system from the hard disk with the new driver 
installed for the first time. If a small bug should exist in the new 
driver, and the initialization routine hangs up, the booting process 
will not end and DOS will be out of control. In such a case, the only 
remedy is to reset the system and boot wiiii a DOS diskette in the 
floppy drive. Once DOS loads, you can then access the hard disk and 
remove the new driver. 


Driver Examples 


This section contains a sample device driver for each of the three different types of 
device drivers, to demonstrate the information you've read about so far. 


The first program is a character driver which corresponds exactly to the format of a 
normal console driver. The second program is a block device driver which creates a 
160K RAM disk. The final program is a DOS clock driver to support an AT 
computer realtime clock. 


¢ g 
oe CONDRV = 
om es cae in es ke om ee ass ds kn ‘cn os ces Sem cw Sew a Gable oat is os is tems Sad ns cess bas Sl eae es ent jee in se en cs ow ew ow en ee ee ee ee - 
i* Task : This program represents a normal Console aes 
Bes Driver (Keyboard and Display Monitor). It should *; 
bas serve as a framework for a driver in the form of *; 
7~ an ANSI.SYS driver. x? 
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* 


Author : MICHAEL TISCHER 
developed on >: 8.4.87 
last Update : 9.21.87 
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* 
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; 

; 

’ 

; 

on assembly : MASM CONDRV; * 
pe LINK CONDRV; * 
;* EXE2BIN CONDRV CONDRV.SYS bl 
0 I was sco genes es Sa cl eicln cs sno Hows Sows eS ns ci we is ed i a as a a as ae ea sees eta ey Ged Sas nes Sep eis Saks Sana mee ean ons es Saanich ns ecm “cs eis se whi an i ni * 
cA 

on Call : Copy into Root Directory, copy the command is 
re DEVICE=CONDRV.SYS into the file CONFIG.SYS * 
;* and then boot the System. * 
pA AR RRARARARRRRRRARANARKAKARARARKARAAARARAKRARARAAAARAERRE EEK EKEREREERE | 
code segment 


assume cs:code, ds:code, es: code, ss:code 


org 0 


; => ConstantS ==========s==s== 


cmd fld equ 2 
status equ 3 
end_adr equ 14 
num_db equ 18 
b_adr equ 14 


KEY SZ equ 20 
num_cmd equ 16 


dw -1,-1 

dw 1010100000000011b 
dw offset strat 

dw offset intr 

db “CONDRV “ 


;-- Jump Table for functions 


fkt_ tab dw offset init 
dw offset dummy 
dw offset dummy 
dw offset no_ sup 
dw offset read 
dw offset read b 
dw offset dummy 
dw offset del in b 
dw offset write 
dw offset write 
dw offset dummy 
dw offset dummy 
dw offset no_sup 
dw offset dummy 
dw offset dummy 
dw offset dummy 
dw offset write 


db ptr dw (?), (?) 

key a dw 0 

key e dw 0 

key bu db KEY S2 dup (?) 


7== Routines and functions of 


;Program has no PSP therefore start 
jat Offset address 0 


2S SS SS SSS SS SSS SSS SS SSS SS ST SS STS SS SS SS SS SS 


;Offset command field in data block 
;Offset status field in data block 
;Offset driver end-adr. in data block 
7;Offset number in data block 

;Offset buffer address in data block 


;Size of key board buffer 
;Subfunctions 0-16 are supported 


ee ee ee ee ete Se cee ee eee YS ID Met SE SS SS RS ED SERN SLE AENNS SELEY SHED Sn AY OE GORD EE SE SAREE MND MED GOS OO cD te eu 


;Connection to next driver 
;Driver attribute 

;Pointer to strategy routine 
;Pointer to interrupt routine 
;new Console driver 


AO ee ee ee ee ee ee ee ee ee ee ee cee me ee ee ee ee me See ee ee wee oe oe 


;Function 0O: Initialization 
7;Function 1: Media Check 
7Function 2: Create BPB 
7Function 3: I/O control read 
;Function 4: Read 

;Function 5: Non-dest. Read 
;Function 6: Input-Status 
7;Function 7: Erase Input-Buffer 
;Function 8: Write 

7Function 9: Write & Verify 
;Function 10: Output-Status 
7Function 11: Erase Output-Buffer 
;Function 12: I/O control write 
7Function 13: Open (starting at 3.0) 
;Function 14: Close 

;Function 15: changeable Medium 
7;Function 16: Output until Busy 


;Address of data block passed 
;Pointer to next character in KEY S2 
;Pointer to last character in KEY S2 
;internal Keyboard Buffer 


Griver cS SSS SS SS SS SS SS SSS SS SS STS 
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strat proc far ;Strategy routine 

mov cs:db ptr,bx :Store address of data block in the 

mov cs:db ptr+2,es ;Variable DB PTR 

ret sback to caller 
strat endp 
7 oe ene ce ee eee AED ORD ee Ew COTY CEES SARS GD OAS HU OE TRAD MAN ST SINT FLED Ee SED MED SOD ION GOED EES RES GUESS CAS NAD ND SLED I SE NED AI UNEP GIO Gi HR END SROE SUID SHAD CLO SAND CEE GRAD SEY GND SND UH Gey SHED SEED COED UD SUED GINE GD GERD NSD GAD UND Mink GN OND 
intr proc far yInterrupt routine 

push ax ;Store registers on the stack 

push bx 

push cx 

push dx 

push di 

push si 

push bp 

push ds 

push es 

pushf ;store also the flag register 

push cs ;Set data segment register 

pop ds ;Code is identical here with data 

les di,dword ptr db ptr;Address of data block to ES:DI 

mov bl,es:[di+cmd_fld] ;Get command-code 

cmp bl,num_ cmd zis command-code permitted? 

jle be_ok 7YES --> bc_ok 

mov ax, 8003h ;Code for “unknown Command" 

jmp short intr_end ;back to caller 

;-- Command-Code was o.k. --> Execute command -----<----------- 
bc_ok: shl bl,1 ;Calculate pointer in jump table 

xor bh, bh ;erase BH 

call [fkt_tab+bx] sCall function 

les di,dword ptr db ptr;Address of the data block to ES:DI 

;-- Execution of the function completed ~+-------------~------ 
intr_end label near 

or ax,0100h ;Set finished-bit 

mov es:(di+status],ax ;store everything in the status field 

popf ;Restore flag register 

pop es ;Restore other registers 

pop ds 

pop bp 

pop si 

pop di 

pop dx 

pop CX 

pop bx 

pop ax 

ret ;back to caller 
intr endp 
7 ee eae ee eee EE OEY ED ED GE SEP SD GE OD ME ET SED SY ete US eine SEED GER ED ES ENED SED SP SUED SEND GEE Mant SUED SD SHOE UND SP AED GD GOP ERY AED Sen) IE STE ED SE SED TD SED SO ENE MANNY SEND SD OR GE SEED SED? SI GID GENE KD ame SS ED QO ne ane 
dummy proc near ;This routine does nothing 

XOr aX,ax ;Erase busy-bit 

ret ;back to caller 
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near 


ax, 8003h 


a ee wee cae ree cee cee re eas mee Se me Oe meee rene aS ete Se Oa OE eee Se GD GEE SR ED GEE OE SD Sete SEAS OND ED ES GD GD cee eee me Ge ES Se Se ED SD SD ED GORD SLED OTH SE came Cae OD OE GED SED CED CEE COR OD Ci Gate SEER 


;This routine called for all functions 
zwhich should really not be called 
;Error: Command not recognized 


zsback to caller 


me cee cere ree ree me re ee rr re ee me ee ae ee ee ee ee ee ee re ee ee ee ee ae ce re re rm rm re ee ree ee ee ee ee ee ee ae ee re te ee ee cee ee ee ete ee ne ee OD DO ES Oo ee 


store c 


store e: 


store c 


mov 
JCxz 
les 
cld 
mov 
MOV 


read_1: cmp 
jne 


read 2: xor 
int 
call 
cmp 
jne 


mov 
call 

read 3: mov 
stos 
inc 
cmp 
jne 


xor 
read 4: loop 
mov 
mov 


read e: xor 
ret 


near 


{ox+key bu],al 
bl 

bl, KEY SZ 
store e 


bl, bl 


cx, es: (di+num_db] 
read e 
di,es:{di+b adr] 


si,key a 
bx, key e 


si,bx 
read 3 


ah,ah 
16h 
store c 
al,0 
read 3 


al,ah 
store c 
al, {sitkey bu} 
: ies 
si 
si, KEY S2 
read 4 


si,si 
read 1 
key a,si 


byte ptr key e,bl 


ax, ax 


;stores a character in the internal 


;keyboard buffer 


7input: AL = character 


: BX = 


Position of the character 


;store character in internal buffer 


;increment pointer to End 
9 


z;End of buffer reached ? 


;NO --> STORE E 


;new end is the beginning of buffer 


jback to caller 


ee a ces re a ree te ee ee Ce EN a GRE ED CHE CO EEN AON OS CD OE EE ES ES ES SSS SE SE ED SN GS NE SE aS DD SY ED SE SE SS GOD SE NY GAD GED GY GED MND GLE NY ND MERE GND SURED ED eS GY UY WEN ON cinaD cam 


;read a certain number of characters 
;from the keyboard to a buffer 


;read number of characters 
jtest if equal to 0 


;Address of character buffer to ES:DI 


70on STOSB count up 


;Pointer to next character in KEY SZ 
;Pointer to last character in KEY SZ 


;other characters in keyboard buffer? 


;YES --> READ 3 


;Function number for reading is 0 
7Call BIOS Keyboard-interrupt 

;Store characters in internal buffer 
jtest if extended code 


;no --> READ 3 


;Extended Code is in AH 


store 


;read character from keyboard buffer 
;transmit to buffer of calling funct. 
;Increment pointer to next character 
7End of buffer reached? 


;NO --> READ 4 


jnext character is the first character 
jin the keyboard buffer 


;repeat until all characters read 
;Store position of the next character 


zin the key board buffer 


7Store position of the last character 


zin the key board buffer 


7everything o.k. 
;back to caller 
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read b proc 


mov 
int 


je 

mov 
xor 
ret 


read _pl label 


mov 
ret 


read b endp 


near 


ah,1l 
16h 
read pl 


es: [di+13],al 
ax, ax 


near 


ax, 0100h 


zread the next character from the 
;key board but leave in the buffer 


7Function number for BIOS-interrupt 
;call BIOS Keyboard-interrupt 
;no character present --> READ Pl 


sstore character in data block 


7everything o.k. 
;back to caller 


;Set busy-bit (no character) 


;back to caller 


Fee ee em RO SUNN ce Se SOY SI NY ID SO RR Ste) I DO Se SD ate RD SO EE OO SEE WE WO A NY OO OO Oat mS Me Re AOU MO MS GR SOND ID POS OED ED SIN COSY GOOD Mie ND GE Gems ORE SES NU SED WINE SD GND eA wevey te Oty cutee Seem 


del _in_b proc 


mov 
int 


del e: 


del_in_b endp 


del inb 


;erase input buffer 


;Still characters in the buffer? 
;Call BIOS key board interrupt 
;no character in the buffer --> END 


;Remove character from buffer 
7Call BIOS key board interrupt 
;Test for additional characters 


;everything o.k. 
jback to caller 


Oe ee cme ee me eee em cee Se ND SD NOY AD SEAN OR uD SD OD GU eS SOND SS Me ee See SE SIU SE SUS GR MED eS EL RES HEE A OU SY SE Sum OE ORE Se GE SOD SO SEE GE GE GRY OO ED CD SES OO EE SEE SD WD EY EN RU ND MRD MONS ceTS mS Ne a 


write proc ne 


MOV 
jcxz 
lds 
cld 


mov 
int 


mov 


lod 
int 


write 1: 


ar 


cx,es: (di+num_db] 
write e 
si,es:(di+tb adr] 


ah,3 
16h 
ah, 14 


sb 
10h 


loop write 1 


write e: xor 


ret 


write endp 


ax, ax 


;write a specified number of 
;characters on the display screen 


;Number of characters read 

;test if equal to 0 

;Address of character-buffer to DS:SI 
;on LODSB increment count 


jread current display page 
7;Call BIOS Video-interrupt 


;Function number for BIOS interrupt 


;read character to be output to AL 
;call BIOS Video-interrupt 
;repeat until all characters output 


;everything o.k. 
;back to caller 


proc 


mov word ptr es:[ditend adr],offset init 


near 


jInitialization routine 


mov es:(ditend_adr+2],cs 


7;Set End-Address of 
sthe driver 
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xor ax,ax yeverything o.k. 
ret z;back to caller 
init endp 
code ends 


The header of this driver describes a character device driver which handles both the 
standard input device (keyboard) and the standard output device (monitor). After 
linking it into the system, setting the two bits in the device attribute calls this 
driver on all function calls previously handled by the CON driver. Like any other 
driver, this driver has a strategy routine and an interrupt routine. The former stores 
the address of the datablock in the variable DB_ PTR. 


The interrupt routine saves the contents of all registers which will be changed by it 
on the stack and gets the routine number to be called from the data block. It then 
checks whether CONDRV supports this function. If not, it jumps directly to the 
end of the interrupt routine and sets the proper error code in the status field of the 
request header which was passed to the routine. Then it restores the registers which 
were saved on the stack and returns control to the calling DOS function. 


For any of the functions that are supported by the device driver, the offset address 
of a routine to handle a particular function is determined from the table labeled 
FKT_TAB. Notice that the routines named DUMMY and NO_SUP appear several 
times. DUMMY is for all functions which apply only to block device drives and 
therefore are not used in this driver. The DUMMY routine clears the AX register 
and sets the BUSY bit in the status word. The NO_SUP routine handles any 
functions which cannot be used since the drive attribute for CONDRV does not 
support these functions. 


The STORE_C routine can be accessed from the lower level routines in this driver. 
Its purpose is to store a character in the internal keyboard buffer of the driver. The 
driver really shouldn't have this buffer available since BIOS (whose functions are 
used by the driver to read characters from the keyboard) also has such a buffer. The 
problem is that the BIOS always returns two characters when pressing a key with 
extended codes (cursor keys, function keys etc.). If the higher level functions of 
DOS only ask for one character at a time from CONDRYV, the second character 
must not be lost. It should be stored in a buffer and delivered to DOS by the read 
function on the next call. This is STORE_C'’s task. 


Reading characters 


The next routine is the READ function. It obtains the number of characters to be 
read from the request header passed by DOS. If it is 0, the routine is terminated 
immediately. If not, then a loop starts which executes once for every character read. 
It first tests for characters still stored in the internal keyboard buffer. If so, a 
character is passed to the buffer of the calling function. If no additional character 
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exists in the keyboard buffer, function 0 of the BIOS keyboard interrupt 16H 
inputs a character from the keyboard. This character is also passed to the internal 
keyboard buffer. If it's an extended keycode, it is divided into two characters. The 
next step removes a character from the internal keyboard buffer and passes the 
character to the buffer of the calling function. The process repeats until all 
characters requested have been passed to DOS. Then the routine ends. 


The higher level DOS functions also call the function named READ_P. It tests 
whether a character was entered from the keyboard. If not, it sets the BUSY bit in 
the status field of the request header passed by DOS, and returns to the calling 
function. If a character was entered without having been read, the driver reads this 
character and passes it to the calling DOS function in the request header, and resets 
the busy bit. The character remains in the keyboard buffer, and on a subsequent call 
of the read function, it is again passed to DOS. To test the availability of a 
character, the READ_P function uses function 1 of the BIOS keyboard interrupt 
16H. 


The function DEL_IN_B also gets called by the higher level DOS functions. 
DEL_IN_B deletes the contents of the keyboard buffer. It removes characters from. 
the buffer using function 0 of the BIOS keyboard interrupt until function 1 
indicates that no more characters are available. This ends the function and it returns 
to the calling function after the busy bit is reset. 


Writing characters 


WRITE takes the number of characters from a buffer passed by DOS and displays 
the characters on the screen. This routine uses function OEH of the BIOS video 
interrupt. Once all characters have been displayed, it sets the BUSY bit in the 
status field and ends the function. This function also executes when the higher 
level DOS functions call the Write and Verify functions. 


Initialization 
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The last function, the initialization routine, is called first by DOS. Since 
CONDRV does not initialize variables and hardware, the routine simply enters the 
driver's ending address into the passed request header. The routine returns its own 
starting address since it will never be called again, and is the end of the chain of 
drivers. 


In its current form the driver has little use, since it uses only those functions 
already available to the CON driver of DOS. It would be more practical if an 
enhanced driver like ANSI.SYS were developed, through which screen design could 
be more tightly controlled. For example, it's possible that such a driver would 
have complete windowing capability which could be accessed from any program, 
in any programming language. 


The following block device driver creates a 160K RAM disk: 
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RAMDISK 


* 


code segment 

assume cs:code,ds:code,es:code, ss: code 

org 0 ;Program has no PSP therefore begin 

sat the offset address 0 

cmd_fild equ 2 ;Offset command field in data block 
status equ 3 ;Offset status field in data block 
num dev equ 13 ;Offset number of supported devices 
changed equ 14 ;Offset medium changed? 
end adr equ 14 7Offset driver end-aAdr. in data block 
b_adr equ 14 ;Offset buffer address in data block 
num_cmd equ 16 ;the functions 0-16 are supported 
num_db equ 18 ;Offset number in data block 
bpb adr equ 18 ;Offset Address of BPB of the media 
sector equ 20 ;Offset first sector number 
dev_des equ 22 ;Offset device-description of RAM-Disk 
erst _b equ this byte sthis is the first byte of the driver 


;-- Header of the Device~Driver 


,;-7 Jump 


fkt tab 


dw -1,-1 


dw 0100100000000000b 


dw offset 
dw offset 
db 1 


strat 
ints 


db 7 dup (0) 


Table for the individual functions 


dw of fset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 
dw offset 


init 
med test 
get _bpb 
read 
read 
dummy 
dummy 
dummy 
write 
write 
dummy 
dummy 
write 
dummy 
dummy 


+ 4 
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g 

ot Task This Program is a Driver for a 160KB el 
hes RAM-Disk. 
3* ‘nine ih mes cts ces ess as eg secs secs rms Sas sco Sa cue sass Wo ‘nl esis nnn enn ses snc ween nos nb cl cms Vn ian mm nb ak eens Sees uses ams ems Com ems Gs eon Us ica sms ie ach ms ‘enn s,s, *« 
-= Author : MICHAEL TISCHER - 
ee developed onm : 8.4.87 * 
om last Update : 9.21.87 * 
gi) acon eis cc en isis ny sees es min i Sins ms ems Wn in cea hms sis same! mas ih “mu uo Ss ba in Ga ms deve mS cs cin Wu we "en Gi ws tis in amo‘ io Sm i cn nn ns‘ eis Gt a’ cu is * 
a” assembly : MASM RAMDISK; 2 
rs LINK RAMDISK; * 
Fie! EXE2BIN RAMDISK RAMDISK.SYS * 
o% aces ee ci em hes Sansa ens ces vps sees nab Sms Torah et Tash ns “akin mm coc es “si es nus hss ea cis Unb ‘soe meas a sas a's (Ge ened i tm in > haw Ses Gees Sc ew ws ow . 
= Call : Copy into Root Directory, enter the command x 
7* DEVICE=RAMDISK.SYS into the CONFIG.SYS file * 
ae and then boot the System, * 
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;Connection to next driver 
;Driver attribute 

7Pointer to strategy routine 
;Pointer to interrupt routine 
ja device is supported 

;these bytes give the name 


;Function 
;Function 
;Function 
;function 
7;Function 
;Function 
7Function 
7Function 
7Function 
7Function 
7;Function 
;Function 
7Function 
;Function 
;Function 


OO se cee em ee St ER TY MY OA AED See NR mY ce) ED SES Oe ee nee oe ee 


Initialization 

Media Test 

created BPB 

direct reading 

Read 

Read, remain in Buffer 
Input-Status 

Erase Input-Buffer 
Write 

Write & Verification 
Output-Status 

Erase Output-Buffer 
direct Write 

Open (after DOS 3.0) 
Close 
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dw offset no_rem 7Function 15: changeable Medium? 
dw offset write 7Function 16: Output until Busy 
db ptr dw (?), (?) ;Address of the data block passed 
rd_seg dw (?) 7;RD_SEG:0000 beginning of the RAM-Disk 
bpb ptr dw offset bpb, (?) ;Accepts the address of the BPB 
boot sek db 3 dup (0) ;normally a jump command to the boot 
;Routine is stored here 
db “MITI 1.0" ;Name of creator & version number 
bpb dw 512 7512 bytes per sector 
db 1 71 Sector per cluster 
dw i 31 reserved sector (boot~-sector) 
db 1 71 File-Allocation-Table (FAT) 
dw 64 smaximum 64 entries in root directory 
dw 320 stotal of 320 sectors = 160 KB 
db OFEh ;Media descriptor (1 Side with 40 
7;Tracks of 8 sectors each) 
dw 1 7every FAT occupies one sector 
;-- the Boot routine not included since a System can not----- 


j-- be booted from a RAM-Disk 


vol_name db “RAMDISK . ;the actual volume-name 
db 8 ;Attribute, defines volume-name 
7;== Routines and functions of the Driver =s======s==ss=s=ese=sssses====== 
strat proc far ;Strategy routine 
mov cs:db ptr,bx ;Store address of the data block 
mov cs:db ptr+2,es ;in the Variable DB PTR 
ret ;back to caller 
strat endp 
intr proc far ;Interrupt routine 
push ax ;Store registers on the stack 
push bx 
push cx 
push dx 
push di 
push si 
push bp 
push ds 
push es 
pushf jalso store flag register 
push cs ;Set data segment register 
pop ds 7;Code identical with data here 


cd 


les di,dword ptr db ptr;Address of data block to ES:DI 
mov bl,es:[(dit+tcmd_fld]) ;Get command-code 


cmp bl,num_cmd ;is command-code permitted? 

jle bc_ok 7YES --> bc_ok 

mov ax, 8003h 7;Code for “unknown Command" 

jmp short intr _end ;back to caller 

;7- Command-Code was 0.k. -~-> Execute Command -------<-----~--- 
bc_ok: shl bl,l ;Calculate pointer in jump table 

xor  bh,bh ;erase BH 

call [fkt_tab+bx] 7Call function 


180 


Abacus 


6.12 DOS Device Drivers 


intr end 


7-- Execution of the function completed -----<---------------- 
label near 

push cs 7;Set data segment register 

pop ds 7Code is identical with data here 


les di,dword ptr db ptr;Address of the data block to ES:DI 
or ax,0100h ;Set finished-bit 
mov es:(di+status],ax j;store everything in the status field 


popf ;Restore flag register 
pop es jrestore other registers 
pop ds 

pop bp 

pop si 

pop di 

pop dx 

pop cx 

pop bx 

pop ax 

ret ;back to caller 

endp 

proc near ;Initialization routine 


prinm: 


7-- the following code is overwritten after the installation - 
j-- by the RAM-Disk 


;-- determine Device designation of the RAM-Disk ------------ 


mov ah,30h 7;Sense DOS Version with function 30 (h) 
int 21h ;of DOS-interrupt 21 (h) 

cmp al,3 zis it Version 3 or higher ? 

jb prinm 7YES --> PRINM 


mov al,es:[ditdev des} ;Get device designation 


add al,"A" ;convert to letters 

mov im _ger,al ;store in installation message 

mov dx,offset initm ;Address of installation message 
mov ah,9 youtput function number for string 
int 21h 7Call DOS-interrupt 


;—-- Calculate Address of the first byte after the RAM-Disk -- 
7-- and set as End Address of the Driver 


mov word ptr es:{dit+tend adr],offset ramdisk+8000h 


MOV ax,Cs ;Size of RAM-Disk is 32KB plus 
add ax, 2000h 72 * 64KB 

mov es: {ditend adr+2],ax 

mov byte ptr es: [(di+num_dev],1 71 device supported 
mov word ptr es: [dit+bpb adr],offset bpb ptr ;Address of the 
mov es: {ditbpb adr+2],ds 7BPB~Pointer 

MOV ax,cs ;Segment address of RAM-Disk beginning 
mov bpb ptr+2,ds ;Segment address of BPB in BPB-Pointer 
mov dx,offset ramdisk ;calculate to offset address 0 

mov cl,4 ;Divide offset address by 16 and thus 
shr dx,cl ;convert into segment address 

add ax,dx 7add the two segment addresses 

mov rd_ seg,ax zand store 

777 Create Boot -SeCtOYr ----- nn en rn rn rn 
mov eS,ax ;transfer segment address to ES 

xor di,di ;Boots. begins with the 1. byte of RD 
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mov si,offset boot_sek ;Address of the boot-sector in memory 


mov cx,15 yonly the first 15 words are used 
rep movsw ;copy boot-sector into RAM-Disk 

go~- Create PAT wnn meme rtm nn tran tree rene en een= 
mov di,512 ;FAT begins with the byte 512 of RD 
mov al,OFEh ;Write media-descriptor into the first 
stosb zbyte of the FAT 

mov ax, OFFFFH ;Store code for bytes 2 and 3 of FAT 
stosw jin FAT 

MOV Cx, 236 ;remaining 236 words occupied by FAT 
inc ax 7;Set AX to 0 

rep stosw 7Set all FAT-entries to unoccupied 


j-- Create Root Directory with Volume-Name -------~------ 


mov di,1024 ;Root Directory starts in 3rd Sector 
mov si,offset vol name ;Address of volume-name in memory 
mov cx, 6 ;the volume-name is 6 words long 

rep movsw ;Copy volume-name into RD 

mov cx,1017 ;Fill the rest of the directories in 


XOr axX,ax ;Sectors 2, 3, 4 and 5 with zeros 
rep stosw 


xOYr axX,ax peverything o.k. 

ret sback to caller 
init endp 
Pee te ee ee a ee ee eee eee 
dummy proc near 7;This Routine does nothing 

xOr axX,ax 7Erase busy-bit 


ret ;back to caller 


med test proc near . ;Media of RAM-Disk 
;Ccannot be changed 


mov byte ptr es: [di+changed]},1 

xOY aX,ax ;Erase busy-bit 

ret ‘ s;back to caller 
med test endp 


Pee ee ee cee cea ate ee ee eae em me omme aree Sete me me erm me ee eee eee Sm mete re ee ee eee eee ee eS re ee ae ee ne SS Me See Sm Meme eres “ENED Gt RD NED GO OU AED SOD SD GD MY Ole OE AD ea ED eS Ge oD oe 


get bpb proc near ;Pass address of BPB to DOS 


mov word ptr es:[ditbpb adr],offset bpb 
mov word ptr es:[ditbpb adr+2],ds 


xXOY axX,ax ;Erase busy-bit 
ret ;back to caller 


no_rem proc near ;Media of RAM-Disk cannot be changed 
mov ax, 20 7;Set busy-bit 
ret sback to caller 
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no_rem 


endp 


ee ee ee ee ree eee ee eee ee ee ee FT OED CS OEE OE RE WE ee unk cent SY OED EE ED ete Gate SEND IRE AL MO SEND SEED CONE HHNED Saha GON Ae SIDS SE OD Go cD SD SANE SELES OOD GES EST GD SONS NNN EEE SUE SUD SID OD AED SRD COED GeO Ge SD SINE SE SY 


write proc near 


xor bp,bp 
jmp short move 


write endp 


read 


Input : BP =0: 


proc near 
mov bp,1 
endp 


:Transmission DOS --> RAM-Disk 
7;Copy data 


re tee re ree ce ae cae ee ee ae SF AD ne te EE OTD OED ORD OED ORD OND TED CUD LS ED STR END CONS OED ENE GY Maly SN SU NT CUD OS OEP CED ED SEN GRD SS SAD SOE HE SREY AD SD GARD UD ARS RAD SND SIT SD SAD GED GENS GONE St Se 


;Transmission RAM-Disk --> DOS 


-- MOVE: Move a certain number of sectors between RD and DOS 
transmit from DOS to RD (Write) 
transmit from RD to DOS (Read) 


~- Registers : AX, BX, CX, DX, SI, DI, ES, DS and FLAGS are changed 
: Information required (number, 


first sector) 


is taken from the data block passed by DOS 


;-- pe 
7-~ Output +: none 
; 
;-~- Info 
move proc near 

mov bx,es:{ditnum_ db] 

mov dx,es:[dit+Sector] 

les di,es:{ditb adr] 
move 1: or bx, Dx 

je move e 

mov ax,dx 

mov cl,5 

shl ax,cl 

add ax,cs:rd seg 

mov ds,ax 

xor si,si 

mov ax,bx 

cmp ax,128 

jbe move 2 

mov ax,128 
move 2: sub bx, ax 

add dx,ax 

mov ch,al 

xor cl,cl 

or bp, bp 

jne move 3 

MOV ax,eSs 

push ds 

pop es 

mov ds,ax 

xchg si,di 
move 3: rep movsw 

or bp, bp 

jne move 1 

MOV ax,es 

push ds 

pop es 

mov ds,ax 

xchg si,di 

jmp short move_1 
move e: xOr ax,ax 

ret 

endp 


move 


;Number of sectors read 
;Number of first sector 
;Address of buffer to ES:DI 


;More sectors to read ? 

;No more sectors --> END 

;Sector number to AX 

;Calculate number of paragraphs 

; (Segment units) by Multiplication 
swith 32, add to Segment start of RD 
;transmit to DS 

7;Offset address is 0 

;Number of sectors to be read to AX 
symore than 128 sectors to read 

7;NO --> read all sectors 

7;YES --> read 128 sectors (64 KB) 
;subtract number of sectors read 
;add to sectorsto be read next 
Number sect. to be read * 256 words 
7;Set Lo-byte of word-counter to 0 
7;Should be read ? 

7;NO --> MOVE 3 

;Store ES in AX 

7;Store DS on the stack 

;read ES 

7ES and DS are reversed now 
yexchange SI and DI 

;copy data into DOS-buffer 

;read ? 

;NO --> maybe other sectors to copy 
;Store ES in AX 

;Store DS on the stack 

jread ES 

7;ES and DS have been exchanged 
7exchange SI and DI again 
;additional sectors to copy 


;everything o.k. 
;back to caller 
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7-- RAM-Disk starts here ---------------~------------ 


if (S-erst_b) mod 16 ;must start on a memory address 
org ($-erst_b) + 16 - (($-erst_b) mod 16) ; divisible by 16 
endif 


ramdisk equ this byte 


initm db “****x 160 KB RAMDISK as Device" 
im ger db "2" 
db ": installed (c) 1987 by MICHAEL TISCHERS",13,10,10 


This driver is similar to the CONDRV driver. The biggest difference between the 
two lies in the functions which each supports. 


Note: The initialization routine INIT here is more comprehensive than the 
CONDRYV initialization routine, and remains in memory after the end 
of execution even though it is no longer needed. You'll see why this 
is so in the paragraph below entitled "The INIT routine". 


First, this routine finds the DOS version number using function 30H. If the 
version number equals or is greater than 3, the request header passed by DOS 
contains the device designation of the RAM disk. The system reads the 
designation, changes it to a character and places the character into the installation 
message. DOS function 09H is used to display this message on the screen. 


Next, the program computes the ending address of the RAM disk. Since the actual 
data area of the RAM disk starts immediately after the last routine of this driver, 
160K is added to the program's ending address. Further, the address of a variable 
(BPB_PTR) containing the address of the BIOS parameter block is passed to DOS. 
This variable describes the RAM disk's format. In this case, it tells DOS that the 
RAM disk uses 512 bytes per sector. Each cluster is made up of one sector and 
only one reserved sector (the boot sector) exists. In addition, only one FAT exists. 
Additional information indicates that a maximum of 64 entries can be made in the 
root directory and that the RAM disk has 320 sectors available (160K of memory). 
The FAT occupies a single sector, and the media descriptor byte FEH designates a 
diskette with one side and 40 tracks of 8 sectors each. 


These parameters are then placed into the request header of DOS and the segment 
address of the data area of the RAM disk is calculated (which the driver itself 
requires, DOS does not need this information). 


The INIT routine 


The RAM disk must now be formatted, to create a boot sector, FAT and a root 
directory. Since these data structures are in the first sectors of the RAM disk, a 
normal INIT routine (which releases its memory to DOS), would overwrite itself 
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with these data structures and would crash the system. This is why the 
initialization routine is not at the end of the last routine of the driver, which would 
place it at the beginning of the RAM disk's data area. 


The boot sector occupies the complete first sector of the RAM disk, but only the 
first 15 words are copied into it since DOS only needs these. The name "boot 
sector" is actually a misnomer here, since it's impossible to boot a system from a 
RAM disk. 


The second sector of the RAM disk contains the FAT. The first two entries are the 
media descriptor byte and 0 in the entries that follow. These zeros indicate 
unoccupied clusters (an empty RAM disk). 


The last data structure is the root directory. It contains no entries other than the 
volume name. 


Remaining routines 


This concludes the work of the initialization routine and returns the system to the 
calling function. The remaining driver routines are examined in order. 


The DUMMY routine performs the same task as the routine of the same name in 
the CONDRV driver. 


The MED_TEST routine is found only in block device drivers. This routine 
informs DOS whether or not the medium was changed. 


The next routine, GET_BPB, simply passes the addresses of the variables which 
contain the address of the BPB of the RAM disk to DOS, as the initialization 
routine had already done. 


NO_REM allows DOS to sense whether the medium (the RAM disk) can be 
changed. You cannot change a RAM disk, so the program sets the BUSY bit in 
the status field. 


The two most important functions of the driver perform read and write operations. 
As in CONDRYV, the program calls Write and Verify instead of the normal Write 
function, since no data error can occur during RAM access. The routine itself does 
very little; it loads the value 0 into the BP register and jumps to the MOVE 
routine. The READ routine performs in a similar manner, except that it loads a 1 
into the BP register. 


MOVE itself is an elementary routine for moving data. The BP register signals 
whether data is to move from the RAM disk to DOS or in the opposite direction. 
The routine receives all other data (the DOS buffer's address, the number of the 
sectors to be transferred and the first sector to be transferred) from the data block 
passed by DOS. See the comments in the MOVE routine for details of the 


procedure. 
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Changes 


This RAM disk can of course be enhanced. If you have enough unused memory, 
you can extend the size of the RAM disk to 360K. AT owners could make the 
RAM disk resident beyond the 1 megabyte boundary. In this case, the data transfer 
between DOS and the RAM disk would use function 87H of interrupt 15H. 


The clock driver 
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This final sample driver directly accesses the battery powered clock of an AT 
computer. It offers the advantage that when the two DOS commands DATE and 
TIME are used, the date and time are passed directly to the battery powered realtime 
clock. Reading the date and time reads the information directly from the memory 


Programming 


locations of the realtime clock. 

FERRER ERE KEE KER KEKE KER EKER EKER KEKE KEK KKHEKEKEKEKKEKKEKEKEKEEKEKEREK EK 9 
bi ATCLK *; 
ial iis iis ii eit cai ie ial i i ne i ei linc Ge cin i as ncn i a ic ne ii wo in i on: es ie cl cs sc ei Ss i ae Gast occ ee san ci cy ec cee ahd 
;* Task : This program is a clock-driver which can be *; 
ad used by DOS for functions which access date és 
* and time on the battery powered clock .> 
;* of the AT. - 
se ire ein ces ws i ila ils cou ci Sn ei i bis to soto sais msi ids ean mats sca xi wm en Sse i cis nists ck nn “is en ass cus ass ees‘ hi sine ts aoa cin Semin Sevan alc Sa tw Sl ke 
;* Author : MICHAEL TISCHER xs 
7* developed on : 8.4.87 a 
zs last Update > 9.21.87 = 
es is sms es as ck Se we Maes sie’ cn ss“ na cs a cast “Aas i seh ens ‘cat's Cans onion abu cose tek asses ks Gasca as Ss Ss Sm tek oe Gs sas ses cs ne Ses mse ew bale 
el assembly : MASM ATCLK; xs 
e LINK ATCLK; = 
al EXE2BIN ATCLK ATCLK.SYS *; 
10° I sas es es ce se cm as sano Sas sis soes et Sms Gin St hm ees ae sess aby aves and vem Sa sas sn acs wes Ss eae an can san a a weal cea Sac Se Ta ae a ak cme cis ia aes Caches A ke 
g v 
;* Call : Copy into root directory place the command 7 
: DEVICE=ATCLK.SYS in the CONFIG.SYS file +; 
a and then boot the system. ar 
FRA ARERE RHEE RIERA EKHKKK EERE RE KERRIER KEKE KKK KKK KEKKEKKEKRKKKKKEKKEKKE 9 
code segment 


ass 


org 


cmd_fld equ 
Status equ 


Ss Seo SL SS LLP LSE SSS LS SSS CSS SSS CcCoSCoSCoCcoccocCcoccocooccoocooeeleSS eS SS SS SS SS See 
2 ;Offset command-field in data block 
3 7Offset status field in data block 
end adr equ 14 ;Offset driver end-adr. in data block 
num_ db equ 18 ;Offset number in data block 
b adr equ 14 ;Offset buffer-address in data block 
;7~- Header of Device-Driver ~---~------------+------------------------- 
dw -1,-1 7Connection to next driver 
dw 1000000000001000b ;Driver attribute 
dw offset strat 7Pointer to strategy routine 
dw offset intr 7;Pointer to interrupt routine 
db “SCLOCK " snew clock driver 
db ptr dw (?), (?) z;address of data block passed 
mon tab db 31 ;Table with number of days in 


ume cs: code, ds:code, es:code,ss:code 


0 7;Program has no PSP, therefore 
zbeginning at offset address 0 
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february db 28 
ab 31, 30,31,30, 31, 31,30,31,30, 31 


;the months 


strat proc 


mov 
mov 


ret 


far 


cs:db ptr,bx 
cs:db ptrt+2,es 


;Strategy routine 


sRecord address of the data block in 
;the variable DB PTR 


j;back to caller 


push 
pop 


les 
mov 
cmp 
je 


cmp 


unk f£kt: mov 


cs 
ds 


jinterrupt routine 


;Save registers on the stack 


;Store the flag register 
;increment for string commands 


;Set data segment register 
7Code is identical with data here 


di,dword ptr db ptr;Address of data block to ES:DI 


bl,es: (di+cmd_fld] 


bl,4 
ck_read 
b1,8 
ck_write 
bl,bl 
unk_fkt 


init 


ax, 8003h 


;Get command~-code 

7;Should Time/Date be read? 

7YES --> CK_READ 

;Should Time/Date be written? 

7YES --> CK WRITE 

;should the driver be initialized ? 
;NO --> unknown function 


yinitialize driver 


;Code for “unknown Command" 


Function Execution completed -~--~----~--<<----<--------- 


intr_end label near 


or 
mov 


popf 
pop 
pop 
pop 
pop 


ax, 0100h 


es: [ditstatus],ax 


es 
ds 
bp 
si 
di 
dx 
cx 
bx 
ax 


7;Set finished-bit 
;store everything in status field 


;Restore flag register 
;Restore other registers 


;back to caller 
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ck_read proc 


mov 

les di,es:[(dit+b adr] 
mov ah,4 

int I1Ah 

call date ofs 
stosw 

mov ah,2 

int 1Ah 

mov bl,ch 
call bed_bin 
stosb 

mov cl,bl 
call bed_bin 
stosb 

xor al,al 
stosb 

mov cl,dh 
call bed bin 
stosb 

xOr ax,ax | 
jmp short intr_end 


ck_read endp 


near 


;Read Time/Date from the clock 


byte ptr es:[ditnum_db],6 ;6 bytes are passed 


7ES:DI points to the DOS-buffer 


z;Read function number for Date 

7Call BIOS Time interrupt 

7Change Date after,roffset to 1.1.1980 
zstore in buffer 


;Read function number for time 
7Call BIOS Time interrupt 
;Store hour in BL 
;convert minutes 

7;Store in buffer 

7Hour to CL 

7;Convert hour 

7;Store in buffer 
;Hundredth second is 0 
;Store in buffer 

7Seconds to CL 

;Convert seconds 

;Store in buffer 


yeverything o.k. 
sback to caller 


mov 
les 


mov 


push 


call 
mov 
MOv 
int 


mov 
call 
mov 
mov 
call 
Mov 


nodiv: add 


nosomo: mov 


proc near 


sWrite Time/Date into clock 


byte ptr es:({ditnum_db],6 ;6 bytes are read 


di,es:[ditb adr] 


ax,es:[di] 
ax 

ofs date 
ch,19h 
ah,9 

1AH 


al,es:[dit+2] 
bin_bcd 
cl,al 
al,es:[dit+5] 
bin bcd 
dh,al 
al,es: [dit+3] 
bin bcd 
ch,al 

di,dl 

ah,3 

1AH 


Calculate Day of the Week 


dx, dx 
ax 

ax, ax 
nodiv 
ax, dx 
Cx, 7 
cx 
dl1,3 
d1,8 
nosomo 
divcl 
al,6 
70h, al 


7ES:DI points to the DOS buffer 


7Get number of days since 1.1.1980 
;store number 

;convert into a date 

7Year begins with 19.. 

7;Set function number for date 
7Call BIOS Time interrupt 


7;Get minute from buffer 
7;convert to BCD 

gbring to CL 

7;Get seconds from buffer 
7;convert to BCD 

zbring to DH 

7Get hours from buffer 
7;convert to BCD 

;bring to CH 

sno summer time 

7;Set function number for time 
7Call BIOS Time interrupt 


;HI-word for division 

;Get number of days from stack 
zis number 0? 

7Yes --> bypass division 
7;HI-word for division 

;week has seven days 

;divide AX by 7 

71.1.80 was a Tuesday (Day 3) 
zis it a Sunday or Monday? 

;NO --> no correction necessary 
7;correct value 

;Location 6 in RTC is day of week 
;Address to RTC-address register 
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mov 
out 


xor 
jmp 


al,dl 
T1lh,al 


ax,ax 
intr end 


ck write endp 


Se Se Re Bo Ve Ve 


-~- Input ;: 
-~- Output : 
-~ Registers 
-- Info 


ofs date proc 


ly: 


lyl: 


mo: 


nolp2: 


mol: 


day: 


-- OFS DATE: Convert number of days since 1.1.1980 into date 
AX = Number of days since 1.1.1980 


7;Day of the week to AL 
;Day of the week to RTC-data register 


peverything o.k. 
sback to caller 


CL = Year, DH = Month and DL = Day 
: AX, BX, CX, DX, SI and FLAGS are changed 
: For conversion of Offsets the Array MON _TAB 


vee. i * 
49 USsea 


near 

mov cl,80 
mov dh,0Ol 
mov bx, 365 
test cl,3 
jne lyl 
ine ui 
cmp ax,bx 
jb mo 
bg vosmmn call 
sub ax,bx 
jmp short ly 
mov bl,28 
test cl,1llb 
jne nolp2 
inc bl 

mov february,bl 
mov si,offset mon_tab 
xor bh,bh 
mov bl, [si] 
cmp ax, bx 
jb day 
sub ax, bx 
inc dh 
inc si 
jmp short mol 
inc al 
call bin_bed 
mov dl,al 
mov al,dh 
call bin_bed 
mov dGh,al 
mov al,cl 
call bin _bed 
mov cl,al 
ret 


ofs date endp 


i-- BIN BCD: Convert Binary-Number to BCD 
: AL = Binary value 
corresponding BCD-value 


; Input 
7—-- Output 


: AL = 


;Year 1980 

; January 

;Number of days in a normal year 
;is year a leap year? 

7;NO --> lyl 

;Leap Year has one day more 
;another year passed? 

7;NO --> Calculate months 

;YES --> Increment year 

;deduct number of days in this year 
;calculate next year 


;Days in February in a normal year 
zis the year a leap year? 

;NO --> nolp2 

jin leap year February has 29 days 
;store number of days in February 


;Address of months table 

;every month has less than 256 days 
;Get number of days in month 
yanother month passed? 

;NO --> calculate day 

7YES --> deduct day of the month 
sincrement month 

7;SI to next month in the table 
;calculate next month 


;the remainder + 1 is the day 
7;Convert day to BCD 

stransmit to DL 

;transmit month to AL 

;convert to BCD 

;move to DH 

;move year to AL 

;convert to BCD 

;ymove to CL 


;back to caller 


;-- Register : AX, CX and FLAGS are changed 


| bed 


proc 


xor 
mov 
div 
shl 


near 


ah,ah 
ch,10 
ch 
al,l 


;prepare 16 bit division 
;work in decimal system 
;divide AX by 10 

;Shift quotient left 4 places 
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bin bed 


™e Ne Be Ve 


™e Sa 


shl 
shl 
shl 
or 

ret 


endp 


-- DATE_OFS: Convert Date in number of days since 1.1.1980 


Input 3; 

-- Qutput ; 
Register 

-- Info 


al,l 
al,l 
al,1l 
al,ah 


7;OR remainder 
sback to caller 


CL = Year, DH = Month and DL = Day 
AX = Number of days since 1.1.1980 


: AX, BX, CX, DX, SI and FLAGS are changed 
: For conversion of date, the Array MON TAB 


is used 


date_ofs proc near 


call 
mov 
mov 
call 
mov 
mov 
call 
mov 


xor 
mov 
dec 


year: cmp 


jb 
test 
jne 
inc 


nolpyr: add 


dec 
jmp 


months: mov 


test 
jne 
inc 


nolpyrl: mov 


xOr 
mov 


monatli: dec 


je 

mov 
add 
inc 


jmp 


add_day: add 


dec 
ret 


bcd_ bin 
bl,al 
el,ah 
bed_bin 
dh, al 
el, dl 
bed_bin 
dl,al 


ax, ax 
ch, bl 
bl 

bl, 80 
monat 
bl, lib 
nolpyr 
ax 

ax, 365 
bl 
short year 


bl, 28 

ch,11b 
nolpyri 

bl 
february, bl 
ch, ch 

bx, offset mon_tab 
dh 

add _ day 

cl, [bx] 

ax, CX 

bx 

short monatl 


ax, dx 
ax 


date ofs endp 


° 
o 
e 
c 
° 
e 
° 
td 


bed bin 


-~- BCD_BIN: Convert BCD to Binary Number 
: CL = BCD-Value 
: AL = corresponding binary value 


-- Input 
-- Output 


;Convert year to binary 


;transmit to BL 


ytransmit month to CL 
;Convert Month to binary 
jand transmit again to DH 
jtransmit day to CL 
;convert day to binary 
sand again transmit to DL 


70 days 
;store year 
;back one year 


;counted back to year 1980 
7;YES --> convert month 
jis year a Leap year 


7NO --> NOLPYR 
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ya leap year has one more day 


jadd days of year 
;back one year 


jprocess next year 


;Days in February in a normal year 
zis current year a Leap Year? 


7NO --> NOLPYR1 


;in Leap Year February has 29 days 


;store in Month table 


severy month has less than 256 days 


;Address of month table 
;decrement number of months 


yall month calculated --> TAG 
;Get number of days in month 


jadd to total-days 


;BX to next month in the table 


7;calculate next month 


jadd current day 


;deduct one day (1.1.80 = 0) 


jback to caller 


-- Register : AX, CX and FLAGS are changed 


proc 


mov 
shr 
shr 
shr 


near 


al,cl 
al,1 
al,l 
al,l 


Ae ne eee eee eee ene eae we ute eee ee ee ee ee 


ee cree ee es cee ee en ee ee ee 


;Convert BCD-value in CL to binary 


yreturn in AL 


;transmit value to AL 
;shift 4 places right 
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shr al,l 

xor ah,ah 7Set AH to 0 

mov ch,10 ;process in decimal system 
mul ch smultiply AX by 10 

mov ch,cl ;transmit CL to CH 

and ch,1111b 7;Set Hi-Nibble in CH to 0 
add al,ch ;add AL and CH 

ret sback to caller 


bed bin endp 
haat proc near ;initialization routine 


;-- the following code can be overwritten by DOS -----~---- 
7-- after installation of the clock 


mov word ptr es:[ditend adr],offset init ;Set end address 


mov es:[ditend_adr+2],cs yof the driver 
mov ah,9 ;Output installation message 

mov dax,offset initm ;Address of the text 

int 21h 7Call DOS interrupt 

xor ax,ax yeverything o.k. 

jmp intr_end ;back to caller 


initm db 13,10,"**** ATCLK-Driver installed. (c) 1987 by" 
db “ MICHAEL TISCHER",13,10,"S" 


aa elke endp 
7 ce ee ere ee ee ere ee ces cre ee a ee ree em ees come ee eee we ens Sas cams cetees Sm cen mem nn ee sm SED ee meen DU SAEED SS sens MD ni age ENS ED ED ETD eS ND GENES OS Sos SEEN GED GD cee EINES GED EE SEOEY OS SS SEED GE aS SS ED GE ne a OE 
code ends 

end 


The basic structure of this driver differs from the other drivers in that it calls the 
individual functions directly, not through a table of their addresses. Since it only 
supports functions 00H, 04H and 08H, it can test the function numbers passed by 
DOS directly. If any other function occurs, it signals an error. Besides the INIT 
routine, which only sets the ending address of the driver like CONDRV, the driver 
only has the Read Time and Date and Write Time and Date functions. 


Time routine 


The TIME routine is fairly simple. For reading the clock, the routine reads the 
time from the memory locations of the clock, converts the time from BCD to 
binary format and then passes the time to the DOS buffer. For setting the time, 
the reverse occurs: The routine reads the time from the DOS buffer, converts the 
code from binary to BCD format and writes the BCD code into the memory 
locations of the clock. 


DOS uses the same format for indicating time as the clock: Hour, minute and 
seconds each comprise one byte. 


191 


6. The Disk Operating System PC System Programming 


Date routine 


The DATE routine is more complicated. While the clock stores day, month and 
year as one byte each, date encoding by DOS is the number of days since January 
1, 1980. This number must be converted into a date in the form of day, month and 
year as DOS writes the time and date. The reverse is true when you call the Read 
function: the clock date must be converted into the number of days. Let's look at 
how this is done. 


The conversion routine starts with the year 1980. January 1, 1980 (called 
NUMDAYS from here on) is equal to the value 0. The routine tests whether this 
year is less than the current year. If so, it adds the number of days in this year to 
NUMDAYS, adding a day to compensate for each leap year. Then it increments the 
year and tests again for a smaller number than the current year. This loop repeats 
until it reaches the current year. The routine then computes the number of days in 
the current year's month of February, and enters this month into a table which 
contains the number of days for each month. 


In the next step, for every month less than the current month, the routine adds the 
number of days in this month to NUMDAYS. Once it reaches the current month, 
only the current days of the month are added to NUMDAYS. The end result is 
transferred to the DOS buffer and the routine terminates. 


Conversion to date format 


Converting NUMDAYS into a date operates in reverse. The routine begins with 
the year 1980 and tests whether the number of days in this year is less than or 
equal to NUMDAYS. If this is the case, the year is incremented and the number of 
days in this year is subtracted from NUMDAYS. This loop is repeated until the 
number of days in a year is larger than NUMDAYS. The routine then computes 
the number of days in the current year's month of February, and enters this month 
into the table of the months. 


January starts another loop which tests whether the number of days in the current 
month is less than or equal to NUMDAYS. If this is the case, the month 
increments and the routine subtracts the number of days from NUMDAYS. If the 
number of days in a month is larger than NUMDAYS, the loop ends. NUMDAYS 
must only be incremented enough to give the day of the month and complete the 
date. 


The routine then converts the date to BCD format and enters the date in the 
memory locations of the clock. 


6.12.10 CD-ROMs 


Soon after their introduction into the audio world, the compact disk industry began 
approaching the PC market. A CD-ROM drive and a PC form an interesting 
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combination. The compact disk medium itself is read-only, but 660 megabytes of 
data can be stored in the form of text, graphics, etc. 


Many publications and references are currently available on CD-ROM, such as: 


° Telephone directories 

° Books in Print 

° The Bibie in various translations 
° The English translation of Pravda 


In addition, maps, photographic libraries, public domain program collections and 
medical databases are available in CD-ROM format. New titles are being published 
daily in this growing market. 


Why CD-ROM? 


The CD-ROM has a clear advantage over the printed medium. Once captured and 
digitized, information can be processed by a computer in whatever form the user 
needs. The possibilities appear to be limitless, considering how easy it is to read 
and compare information. 


Another important consideration is the ease of access for many users. Load the 
driver software, press a key or two, and the information is on the screen and ready. 


You can buy a PC-compatible CD-ROM player for $800 to $1,000 at the time of 
this writing. These players are available as either external or internal devices. 


Interfacing 


The PC's hardware can be easily interfaced to a CD-ROM player. The software 
may encounter some problems, however. This is understandable, since DOS was 
never intended to support these devices. This subsection shows how a CD-ROM 
drive, using the proper drivers and utility programs, can be accessed like a read- 
only floppy disk drive. This information may not be of immediate use to you. 
However, this data will give you a closer look into the world of the device driver 
and operating system organization. 


This book mentioned earlier that the device drivers act as mediators between the 
disk operating system and the external devices such as monitor, printer, disk drives 
and hard disks. DOS differentiates between block device drivers and character device 
drivers. As a mass storage device capable of reading information in a block mode, a 
CD-ROM drive would normally be added to the rest of the system through a block 
driver. Here's where the problem begins: DOS makes a number of assumptions 
about block devices, and a CD-ROM drive cannot meet the criteria of these 
assumptions. 
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Memory limitations 


In versions of DOS up to and including Version 3.3, the biggest obstacle to 
interfacing with a block driver was the 32 megabyte limit imposed on every 
volume designated as a block device. The second biggest obstacle is the lack of a 
file allocation table (FAT) on a CD-ROM. Instead of the FAT, the CD-ROM 
contains a form of data table into which the starting addresses of the various 
subdirectories and files are recorded. However, DOS still demands a FAT which it 
can at least read during driver initialization. 


A character driver works better for implementing a CD-ROM driver, since DOS 
makes no assumptions about the structure of the devices connected through 
character drivers. Even character drivers are poorly suited for communication with a 
CD-ROM drive, since they transmit characters one at a time instead of in groups 
of characters. Another disadvantage is the need for a name (e.g., CON) instead of a 
device designation. DOS must first see the CD-ROM driver as a character driver to 
DOS to prevent read accesses to a non-existent FAT. The CONFIG.SYS file 
supplies the name of the device during the system booting process. 


Configuring the CD-ROM 


Driver 
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The manufacturer usually includes CD-ROM driver software with the CD-ROM 
drive package. A driver of this type usually has a name such as SONY.SYS or 
HITACHI.SYS, depending on the manufacturer. 


The CONFIG.SYS sequence which installs this driver can look something like 
this: 


DEVICE=HITACHI.SYS /D:CDR1 
The device driver selects the name CDR1 as the name of the CD-ROM drive. 


After executing the initialization routine from DOS, the CD-ROM is treated as a 
block driver which has been enhanced with a few special functions supporting CD- 
ROMs. However, DOS still views the CD-ROM player as a character driver: DOS 
cannot view the CD-ROM's directory, nor can it directly access the files on the 
CD-ROM. 


software extensions 


To overcome this obstacle, many CD-ROM players come with a TSR (Terminate 
and Stay Resident) program named MSCDEX (Microsoft CD-ROM Extension) in 
addition to the device driver software (see Chapter 8 for information on TSR 
programs). This program must be called from within the AUTOEXEC.BAT file. 
The name of the CD driver can be passed to the program from the DOS prompt, as 
shown in the following example: 


MSCDEX /D:CDR1 
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MSCDEX first opens this driver through the DOS OPEN function and provides it 
a device designation. DOS assumes that MSCDEX is a device on a remote 
network, as supported by DOS in Version 3.1. 


MSCDEX brings us closer to the solution, since DOS handles network devices as 
files containing more than 32 megabytes. These devices are accessed through 
redirection, rather than direct access from DOS. The resident portion of MSCDEX 
interfaces to the redirector, and intercepts all calls to the redirector. If MSCDEX 
receives a call addressed to the CD-ROM drive, it adapts each instruction to a call 
applicable to the CD-ROM driver. This makes a perfect connection between DOS 
and the CD-ROM drive, while still allowing access to subdirectories and files at 
any time. 


To network 
redirector Network call 


DOS command 
(e.g., DIR) Command CD-ROM 


interpreter 
COMMAND . COM 


device driver 


Keyboard 


CD-ROM access through MSCDEX and its device driver 
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6.13 


DOS Mass Storage 


Many tasks performed by DOS are unseen by the user. This is why some users 
underestimate the complexity of DOS. For example, DOS requires many data 
Structures for handling a mass storage device, and the user may not realize this. 
This section looks deeper into DOS and reveals the architecture and operation of 
these data structures. 


From the user's viewpoint, DOS addresses mass storage devices as volumes where 
each individual volume has been assigned a letter. Floppy disk drives are identified 
by the letters A and B, while the letters C or D usually identify a hard disk. A 
mass storage device can have several volumes. This division into several volumes 
or partitions is very practical for hard disks. Partitions on a floppy diskette don't 
work as well due to the limited amount of storage space. A hard disk may be 
divided into additional partitions if UNIX (or XENIX) is used in addition to DOS. 
Each of the two operating systems then has its own volume which is also 
designated by its own letter. 


Volume names 


Sectors 
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Each volume can be assigned a volume name when created, but this volume name 
is not a requirement. The DIR command lists volume names when they are 
available. Each volume has its own root directory, which can contain multiple 
subdirectories and files. These subdirectories and files can be maintained and 
manipulated by using one or more of the interrupt 21H functions. 


DOS subdivides each volume into a series of sectors. These sectors are organized 


sequentially. Each sector contains a specific number of bytes (usually 512) and is 
assigned a consecutive number beginning with sector 0. Since function calls with 
interrupt 21H are directed to files rather than individual sectors, DOS converts 
these file accesses into sector accesses. To do this, DOS uses directories and a data 
structure known as the FAT (file allocation table), which you read about earlier in 
this book. After the desired sector number has been determined, control is passed to 
the device driver which translates this sector number into a physical address. Mass 
storage devices such as floppy and hard disks are divided into individual tracks 
which contain a certain number of sectors. In addition to the physical sector 
number, the driver must also determine the number of the track and the number of 
the read head. 
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Manufacturer's name, device driver, boot routine 


number 


Data register for files and subdirectories 


Mass storage device structure 


As mentioned above, every volume is divided into various areas containing the 
various DOS data structures and individual files. Since the size of the individual 
areas can differ depending on the type of mass storage device (and the 
manufacturer), every volume contains a boot sector. The boot sector contains all 
the information required to access to the different areas and data structures. DOS 
creates this sector during disk formatting. Boot sectors always have the same 
structure and are always located in sector 0 so that DOS can find and interpret it 


properly. 


The following illustration shows the layout of the boot sector. 


(3 bytes) 


00(h) {Jump command to boot routine 


(E9xxx or EBxx90) 

OB (h) 
13(h) 
15 (h) 
18 (h) 


BOOT ROUTINE 


Boot sector layout 


BPB 


PIP TY = HEL OLo ro) 
FIO T> oO FPIiolmivo Ww 
sisis > SISiS Sists 
; 
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Boot sector 


The name boot sector comes from the fact that DOS boots (i.e., starts) from it. 
DOS is loaded and started from disk—it is not usually stored in permanent PC 
memory (ROM). After you turn the computer on, the BIOS takes over the system 
initialization and loads logical sector 0 of the floppy or hard disk into memory. 
Once it completes its work the BIOS starts execution at address 0. 


197 


6. The Disk Operating System PC System Programming 


The boot sector always contains an assembly language JUMP instruction at 
address 0. After execution the program continues at a location further into the boot 
sector. This instruction can be either a normal jump instruction or a "short jump." 
Since the field for this jump instruction is 3 bytes long, but a "short jump" only 
requires 2 bytes, a NOP (No Operation) instruction always follows the "short 
jump" to fill in the extra byte. This NOP does nothing. A series of fields follow 
which contain certain information about the organization of the media. The first 
field is 8 bytes long and contains the manufacturer's name, where this medium was 
formatted, as well as the DOS version number which performed the formatting. 
The next fields contain the physical format of the media (i.e., the number of bytes 
per sector, the number of sectors per track, etc.) and the size of the DOS data 
structures stored on the media. Since the BIOS and DOS-BIOS functions represent 
the lowest level of access to disk drives and hard disks, this area is also designated 
as the BIOS parameter block (BPB). Three additional fields, which can provide 
additional information to the device driver about the media, follow the BPB; these 
three fields aren't used directly by DOS. 


Bootstrap 
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Next comes the bootstrap routine to which the jump instruction branches at the 
beginning of this boot sector. It handles the loading and starting of DOS through 
the individual system components (see Section 6.3). 


Several reserved sectors may follow the boot sector. These reserved sectors can 
contain additional bootstrap code. The numbers of these sectors are recorded in the 
BPB in the field starting at address OEH. It terminates the boot sector and a 1 in 
this field indicates that no additional reserved sectors follow the boot sector (this 1s 
the case for most PCs). 


In order for DOS to add new files or enlarge existing files, it must know which 
sectors of the media are still available. This information is contained in a data 
structure called the FAT (file allocation table) which is immediately adjacent to the 
media's reserved area. Each entry in the FAT corresponds with a certain number of 
logically contiguous sectors, called clusters, on the media. Location ODH of the 
boot sector specifies the number of sectors per cluster as part of the BIOS 
parameter table. Only multiples of 2 are legal values. On an XT hard disk this 
location contains the value 8 (8 consecutive sectors form a cluster). As the 
following table demonstrates, the number of sectors comprising a cluster depends 
on the storage medium. 


Sectors per cluster 
Single sided disk drive ee 
Double sided disk drive = 


[AT hard disk 
XT hard disk 


The reason for joining several sectors into a cluster is derived from the logic used 
by DOS to write files to a media. It disassembles the file to fit the pieces into the 
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sectors which are still available, instead of selecting adjoining sectors for file 
storage. This process slows file access since the read/write head must be 
repositioned after almost every read function. To avoid an excessive disassembly of 
the file, DOS gathers several sequential sectors on the media into a cluster. This 
ensures that at least the sectors of a cluster contain a portion of a file. If DOS 
didn't use clusters, a file of 24 sectors could be stored in many separate sectors, 
which would require the read/write head to be positioned a maximum of 24 times 
to read the entire file. The cluster principle saves a lot of time, since the file is 
stored in 6 clusters and the read/write head only has to be repositioned 6 times. 


There is a problem however. Since a file is assigned at least one cluster, some 
storage space is wasted. Consider AUTOEXEC.BAT which is usually no longer 
than 150 bytes. Normally, a single sector could contain this file (and still waste 
almost 400 bytes), but AUTOEXEC.BAT occupies a cluster of 2048 bytes on an 
AT, which wastes more than 1.5K of hard disk space. 


Now back to the file allocation table: 


The size of individual entries in the FAT under DOS Versions 1 and 2 is 12 bits. 
For DOS Version 3 and later, the size of an entry in the FAT depends on the 
number of clusters: if a volume has more than 4,096 clusters, then each FAT entry 
is 16 bits; otherwise each FAT entry is 12 bits. The number of bits per FAT entry 
must be determined before file access. The information in the BIOS parameter 
block is used for this purpose. The total number of sectors in the volume can be 
found starting at location 13H. Divide this number by the number of sectors per 
cluster to obtain the number of clusters in the volume. 


The first two entries of the FAT are reserved and have nothing to do with the 
cluster assignment. Depending on the sizes of the individual entries, 24 bits (3 
bytes) or 32 bits (4 bytes) can be available. The first byte contains the media 
descriptor, while the value 255 fill in the other bytes. The media descriptor, which 
is also stored in address 15H of the BPB, indicates the device which the media uses 
(for example a diskette). The following codes are possible: 


5.25" disk drive (AT only) 

2 sides, 80 tracks, 15 sectors 
5.25" disk drive 

1 side, 40 tracks, 9 sectors 


15.25" disk drive 
2 sides, 40 tracks, 9 sectors 
5.25" disk drive 
1 side, 40 tracks, 8 sectors 
5.25" disk drive 
2 sides, 40 tracks, 8 sectors 


This shows the various diskette formats which DOS supports in 5.25" diskettes. 
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Included in DOS version 11.00) f1.10 [2.00 [2.00 [3.00 


Media descriptor 5s CC FEU UCC CCU FO 
Number of read/write heads [1 |2_ fa S22 
|Wunber of tracks per head [40 [40 [40 [40 feo_— 
Number of sectors per clusterf1 [2 [i [2p __| 
Number of reserved sectors [T [1 (ti. 
Number of sectors per FAT  J1 92 [2 [2 7 J 
Number of Fats Sd? —id2 Cid? Sid Cid 
Number of sectors 7 7 14 
Farce ers a (eA (A 
in root director 

Total number of sectors |. 320___— 6403607202400 
[Free sectors for data 313. 620351708 2372 
Total file capacity si. 156.5K4315K__]175.5K{354K__|1.185Meg 


DOS 5.25" diskette formats 


You may have wondered why the individual entries of the FAT are 12 or 16 bits 
wide if all they do is indicate whether a cluster is occupied or not. This could have 
been done with one bit: The bit could contain 1 when the cluster is occupied and 0 
if the cluster is available. The reason is that the entries in the FAT help mark the 
available clusters and identify the individual clusters containing a specific file. The 
directory entry of a file tells DOS which cluster holds the first data of a file. The 
number of this cluster corresponds to the number of the FAT entry belonging to 
it. In this entry is the number of the cluster containing the next sector of file data. 
As the following illustration shows, a chain forms in which the individual clusters 
assigned to a file can be located in the proper sequence. 
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Media descriptor Directory entry for 
entry number FAT FORMAT.EXE file 

s cgumrmmmere 

Tig 

25 

Se 

4 BOOS oe 

5. [006 (h) | 

«|| form 

2 [008 (h) 

8. 00D (h) 

9 : See ae 

A. 

B. 

Cs 

D. 008 (h) | 

E. 

FAT entry and file clusters 


The FAT entry which corresponds to the last cluster of a file must contain a 
special code which tells DOS that the file ends here. The following table shows 
the meanings of the various FAT entries. 


Note: 


The first hexadecimal number in parentheses refers to a FAT whose 
entries are 16 bits wide. 


DOS is designed so that several identical copies of the FAT on the media may be 
kept. This offers the advantage that in case of damage to one FAT, it can be 
replaced with another, preventing data loss. 


The DOS CHKDSK command tests the various FATs to see if they are identical. 
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Directory structure 
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Now let's look at the structure of a directory. 


The root directory of a volume immediately follows the last copy of the FAT. 
This root directory (like all subdirectories) consists of 32-byte entries in which 
information can be stored about individual files, subdirectories and volume names. 
The maximum number of entries in the root directory, and therefore its size, is 
stored in the BPB starting at address 11H. The FORMAT command specifies both 
the size number and the BPB. Before considering individual fields of this data 
structure, here's a graphic overview of a directory entry: 


Filename (blanks padded w/ spaces 8 bytes 


+ 18H 


Directory entry layout 


The first 8 bytes normally contain the name of the current file. If the filename is 
shorter than 8 characters, DOS fills the remaining characters with spaces (ASCII 
code 32). If the directory entry does not contain information on a file, but the file 
is used in another manner, the first byte of the filename (therefore the first byte of 
the directory entry) is identified by special code: 


Last directory entr 


First character of filename 
has ASCII code E5H 


director 


The second field contains the three character filename extension. If the extension is 
less than three characters in length, DOS fills in the extra characters with blank 
spaces (ASCII code 32). The period between filename and extension is displayed by 
the DOS command DIR but is not kept in the directory; DIR displays it just to 
make the names between easier to read. 


Next follows the one-byte attribute field. As shown in the following figure the 
individual bits of this field define certain attributes. The various attributes can be 
combined so that a file (as in the IBMBIOS.COM file) can have the attributes 
READ_ONLY, SYSTEM and HIDDEN. 
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76 5 4 23 2 ~ 1 
_| i | | | | | |—hitsaawrite enabled 


T 
(invisible to DIR) 
archive bit 


Attribute field in the directory 


While the significance of bits 0 to 4 is easy to see, the significance of bit 5 needs 
additional explanation. The name archive bit comes from its use in making backup 
copies. Every time a file is created or modified, this bit is set to 1. If a program is 
used to backup this file, (for example the DOS BACKUP command), the archive 
bit is reset to 0. The next time the BACKUP command is used, it can determine 
from the archive bit whether this file has been modified since the last backup. If it 
still contains the value 0, the file doesn't have to be backed up again. If the archive 
bit contains a 1, the file was modified and should be backed up again. 


The attributes volume name and subdirectory will be discussed in more detail 
below. 


A reserved field which DOS requires for internal operations follows the attribute 
field. 


The time and date fields indicate when the file was last created or modified. Both 
are stored as words (2 bytes), but have special and different formats. 
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15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 OQ bit 


re eh ee ee a ae 
Hour Minute Seconds in 
2-second 
increments (e.g.,)t 
(13 means 26) 


15 14 13 12 1110 9 8 7 6 5 4 3 2 =1 +#=O bit 


i [eee ae marae 


Year (relative to 1980) Month Day of month 


Time/date field formats in directory entry 


The next field indicates the number of the cluster which contains the first data of 
the file. It also indicates the number of the FAT containing the number of the next 
cluster assigned to the file. This field forms the beginning of a chain through 
which all the clusters assigned to a file can be retrieved. 


The file size in bytes is stored in 2 words with the lower word stored first. Using a 
small formula and the two words, the file size can be calculated as follows: 


File size = wordl + word2 * 65,536 


Subdirectory and volume name 
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Both subdirectory and volume name deserve special consideration. The volume 
name can only exist in the root directory and is indicated by bit 3 of the current 
directory entry's attribute field. The filename in a volume entry acts as the volume 
name; the DOS commands DIR, VOL and TREE can be used to display the 
volume name. 


If bit 4 of the current directory's attribute field is set, then this entry is for a 
subdirectory. If in addition bit 1 in this field is set, the subdirectory can be 
addressed, but will not be displayed when you execute the DIR command. For 
these entries, the filename and extension field contain the subdirectory name; the 
date and time field contain the time of its creation. The file length field is always 
0. The field which normally indicates the first cluster of the file now indicates the 
cluster which contains the directory entries of this subdirectory. They have the 
same 32-byte structure as the entries in the root directory. As in a normal file, the 
entry in the FAT, which corresponds with the subdirectory cluster, points to the 
next cluster of the subdirectory, as long as one cluster is enough for the directory 
of the subdirectory. This is not true of the root directory which extends through 
several sectors or clusters, which follow each other logically. Furthermore the 
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individual clusters of the root directory cannot be connected through the FAT, 
because it only refers to the data area of the volume. This is the area which accepts 
files and subdirectories, but not the root directory. 


The process described above reveals that DOS separates the individual files in a 
storage unit according to their directories. It doesn't store the files of one directory 
in one area, but scatters the files across the storage medium. 


When a subdirectory is created, two files are created with the names '.’ and "..’ 
which can only be erased when you remove the entire subdirectory. The first of 
these two files points to the current subdirectory, and its cluster field contains the 
number of the first cluster of the current subdirectory. The second entry points to 
the parent directory, which in the directory tree is located ahead of the current 
directory. If the parent directory is the root directory, the cluster field contains the 
value 0. The path to the root directory can be traced back through this entry, since 
as every subdirectory searches for its parent directory it comes closer to the root 
directory. 


Now back to our discussion of mass storage device structures. The file area follows 
the root directory just described. It occupies the remaining storage area of the mass 
storage device. It accepts the individual files and various subdirectories. For every 
cluster in this area there is an entry in the FAT corresponding to this cluster. If a 
file is enlarged, DOS reserves a cluster which is still available to store the 
additional data of the file. The FAT entry of the last cluster which formerly 
indicated the end of file is changed to point to the new cluster which in turn 
contains the new end character. In DOS Versions 1.0 and 2.0, unused clusters are 
searched for from the beginning. In DOS Versions 3.0 and up, a more 
sophisticated search is used to try to select an unused cluster in the vicinity of 
other clusters comprising the file. This reduces the access time to the file as much 
as possible. Conversely, when reducing file size or deleting a file, the FAT is 
updated to indicate that the unused clusters are again available. They can be used 
again when a new file is created or expanded. 
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This book discusses three methods of accessing PC hardware. On the one hand, 
you can access available DOS or BIOS functions. On the other hand, you have the 
option of developing new functions and routines for direct hardware control. While 
this offers no advantage in mass storage device and keyboard access, special 
routines for screen display are often much faster and more efficient than BIOS and 
DOS routines used to do the same job. 


For compatibility, however, DOS functions win hands down. Those of you who 
want to develop programs which can run, without problems, on virtually any DOS 
computer, must observe some rules for DOS function calls. These rules also apply 
to future compatibility. To develop programs under the current DOS versions 
which should execute without problems under future versions of DOS, you should 
follow the suggestions made below. 


° Use only DOS functions for screen and hardware access. Do not use BIOS 
or other hardware dependent functions. 

° Display error messages on the standard error device (handle 2). 

° Use Version 2 UNIX-compatible handle functions for file access. This 


ensures compatibility with future versions of DOS. 


e If you use the old FCB functions for file or directory access (e.g., for 
special attributes), make sure no FCBs are opened which are already open, 
and no FCBs are closed which are already closed. This could cause 
problems in a network. 


° Check the DOS version number at the beginning of the program and end 
the program with an error message if it cannot be executed under this 
version. 

° Store as many constants as needed for program execution (e.g., the paths 


of programs and files to be loaded) within the environment block. Access 
these values from the environment block within the program. 


. Release all memory not required by the program using the DOS functions 
(this is especially important when working with COM programs). 

° If you need additional memory, request it by using the proper DOS 
functions. 

° Use the available DOS functions for interrupt vectors; do not access 
interrupt vectors directly. 

° To change the contents of various interrupt vectors within a program, 


first save the old contents and restore them before the end of the program. 
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° Call one of the DOS functions (31H or 4CH) before the end of the 
program to pass a value to the calling program to signal whether the 
program was executed correctly. Avoid using the other functions for 
ending a program (interrupt 20H and function 0 of interrupt 21H). 


° Use function 59H of interrupt 21H (available in DOS Versions 3.0 and 
higher) to localize error sources. 


In conclusion, here is an overview of the older DOS functions to avoid, and the 
new equivalent functions that can replace them. 


Old New 
OOH End program 4CH End Process 
4FH_ Find next _entr 
4 . 
3CH__Created_handle e 


4 
po SA Created temporary file or _ 
DS Sees Sa ce eed 
6H Rename directory entr 

FH Read (through handle) 

2H Move file pointer 

BH Load and execute from file 
FH Read (through handle) 


28H Random access write OH Write (through handle) 


Sy) 


BH Created new file 


OUR TO1m 6) 


pay 


15H Sequential write OH Write (through handle) 


Dd 


WESTER 


> 


If you follow all these suggestions, your programs will execute on other 
computers and under future DOS versions with little or no modifications. 


207 


6. The Disk Operating System PC System Programming 


6.15 Undocumented DOS Structures 
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DOS manages the operating storage media (RAM and mass storage) and programs 
which use multiple data structures. Some of these structures are thoroughly 
documented and have already been described in this book. These documented 
structures include: 


° Program Segment Prefix (PSP), which precedes every program in 
memory 

. File Control Blocks (FCBs), which control file access 

: Memory Control Blocks (MCBs), which control RAM 

° Structures in the header of a device driver 

° Environment blocks, which contain information strings about every 


program in memory 


° The many structures which DOS keeps in mass storage (boot sector, File 
Allocation Table [FAT], root directory, etc.) 


In addition, there are a number of undocumented structures. Until quite recently, 
only a few people knew of the existence of these structures, since most technical 
manuals concerning DOS didn't describe them. The authors of many of these 
technical manuals felt that these structures weren't needed for programming, and 
that their coding would change in future versions of DOS. The fact is that certain 
kinds of programming do depend upon these structures, and that some applications 
couldn't be realized at all without them. 


Floppy disk and hard disk management utilities make intensive use of the 
undocumented structures. If you examine the Norton Utilities® using a debugging 
application, you'd see how much this program accesses these structures. 


A minor change in these structures took place between DOS Version 3.3 and 
Version 4.0, but this is the first change since the introduction of DOS Version 2.0 
in 1983. Therefore, the chances are almost nil of finding altered coding in the 
undocumented structures of subsequent DOS versions. 


Knowing about these structures can be practical data for programming some 
applications. This section lists our findings from viewing the Norton Utilities®. 


The DOS Info Block (DIB) is the key to accessing the most important DOS 
structures. This block holds pointers ‘> several DOS structures and to other 
information as well. The knowledge of its existence and construction is useful to a 
program only if its address in memory is known. This address is not in a fixed 
memory location, nor can it be obtained with any of the documented functions of 
DOS interrupt 21H. However, the undocumented function 52H can offer us some 
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assistance in finding that address. Calling function 52H returns the address of the 
DOS Info Block to the ES:BX register pair. 


As opposed to all other DOS functions that fetch pointers to a structure or data 
area, the contents of the ES:BX register pair point not to the first, but rather to the 
second field within the DIB after the function call. 


DOS Info Block (DIB) structure 
Contents Type | 
Pointer to MCB 

Pointer to first Drive Parameter Block (DPB) 
Pointer to last DOS buffer 

Pointer to clock driver ($CLOCK) 

Pointer to console driver (CON) 

Maximum sector length (based on all connected ]|1 word 
mass storage devices) 

Pointer to first DOS buffer 
Pointer to path table 

Pointer to System File Table (SFT) 
Length: 1EH (30) bytes 
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The first field in the DIB contains a pointer to the Memory Control Block (MCB) 
of the first allocated memory area. You will find detailed information on this 
structure and what it does in Section 6.9 (Memory Allocation from DOS). The 
pointer in the second field of the DIB gives access to a wealth of information that 
could not be had in any other way. It points to the first Drive Parameter Block 
(DPB), a structure which DOS lays out for all mass storage devices (floppy disks, 
hard disks, tape drives, etc.). 


Drive Parameter Block (DPB) structure 


Contents Type 
Number or symbol for corresponding drive 1 byte 

(0 = A, 1 = B, etc.) 
[+01H_ | Sub-unit of device driver for drive | byte _| 
1_word 
+04H_ | Interleave factor dd byt 
+05H | Sectors per cluster dd byte 
[+06H | Reserved sectors (for boot sector) tL word | 
+08H_ | Number of File Allocation Tables (FATs) | 1 byte _| 
1_word 
1_word 
1_word 
+0FH_ | Sectors per FAT byte | 
j+10H_ [First data sector word 
[+12H_ | Pointer to header (correspond. device driver) |1 ptr 
Media descriptor | 
[+17H_ | Used flag (OFFH=device not_yet in use) | byte 
i+18H | Pointer to next DPB (xxxx:FFFF = last DPB) 


Length: 1CH (28) bytes | 
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The first field of the DPB tells us to which device the block belongs. O stands for 
drive A, 1 for B, 2 for C, etc. The second field specifies the number of the subunit. 
To understand the meaning of this field, remember that access to the individual 
devices occurs through the device driver. DOS doesn't perform direct access to a 
disk drive or hard disk. This keeps DOS from having to deal with the physical 
characteristics of a mass storage device. Instead, DOS calls a device driver for this 
purpose, which acts as mediator between DOS and hardware. 


Of course, not every device has a separate device driver, since one device driver can 
support many single devices. For example, the device driver built into DOS 
manages the floppy disk drives and the first available hard disk. DOS configures a 
DPB for each device, so a hard disk system would automatically have 3 DPBs 
available (a DPB is always configured for floppy drive B, even if only one floppy 
drive is actually available). Each device receives a number between 0 and the total 
number of devices minus 1, to help each driver to identify the devices it manages. 
This number is the one found in the subunit field. 


The next field lists the number of bytes per sector. Under DOS this is almost 
always 512. After this comes the interleave factor, which gives the number of 
logical sectors displaced by physical sectors when the medium is formatted (more 
on this in Chapter 7). This value can be 1 for floppy disk drives, 6 for the XT hard 
disk and 3 for the AT hard disk. For floppy disk drives, this field can also have the 
value FEH if no access has been attempted to the disk in the drive. The value FEH 
means that the interleave factor is currently unknown. 


There are a number of other fields related to these two which have already been 
named in connection with the management of mass storage devices through DOS 
(see Section 6.13). Among other things, they describe the status and the size of the 
structures DOS created to manage mass storage devices. A pointer to the header of 
the device driver lies within these fields. DOS uses this pointer when accessing the 
device. More information can be obtained with this pointer since, for example, the 
driver attribute is listed in the header of the device driver. 


Following this field is the media descriptor to which the Used flag is connected. 
As long as no access to the device has occurred, this flag contains the value OFFH. 
After the first access it changes to 0 and remains unchanged until a system reset. 


The DPB ends with a pointer that establishes communication with the next DPB. 
Since every DPB defines its end with such a pointer, a kind of chain is created, 
through which all DPBs can be reached. To signal the end of the chain, the offset 
address of this pointer in the last DPB contains the value OFFFFH..When a 
program needs the information within the DOS, there are many ways to find the 
address of the desired DPB. One method is to follow the chain described above by 
first finding out the address of the DIB. This gives you the pointer to the first 
DPB, from which you can follow the chain until you reach the DPB you want. 
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There's a better way, which isn't as susceptible to changes within the DIB, through 
two undocumented DOS functions. This involves the 1FH and 32H functions, 
which have been part of the DOS function repertoire since Version 2.0, although 
not documented by Microsoft. When called, both return a pointer to a DPB to the 
DS:BX register pair. While function 1FH always delivers a pointer to the DPB of 
the current disk drive, the address delivered by function 32H refers to the device 
whose number is passed to the function in the DL register at the time it's called. (0 
represents the current drive, 1 is drive A, 2 drive B etc.). It's much more flexible 
than function 1FH. 


Access to the various DPBs with the 1FH and 32H functions offers a further 
advantage, because it forces DOS to retrieve other information such as the 
interleave factor and the media descriptor byte, which is ascertained for the disk 
drive only after the first access. If you get to the DPB through the pointer in the 
DIB block, the various fields may not have been initialized, and could contain the 
wrong values. 


Besides the pointer to the first DPB, the DIB contains the pointer to the first DOS 
buffer at address 12H. These DOS buffers store individual sectors, so that the 
sectors don't have to be repeatedly loaded from disk. The DOS buffers can be most 
effective when used for storing disk sectors that are frequently needed by the 
currently running program. Besides the FAT, these include the root directory and 
its subdirectories. The number of buffers can be defined by the user in the 
CONFIG.SYS file. If this number exceeds those needed for the FAT, root directory 
and subdirectories, normal sectors can also be temporarily stored here, in the hope 
that they are called to be loaded again in the near future, and can be taken directly 
from the buffer. 


So that DOS can quickly check each buffer for the desired sector with every read 
operation, the individual sectors are linked together. 


DOS buffer structure 


Drive number (0 = A, 1 = B etc.) 
s 


rey 
ceed 
fy 
) 


+O06H Sector number 1 word 
Reserved 


+OAH Contents of buffered sector 12 bytes 


Length: 210H (528) bytes 


+ +f+]4+ ]> 
oO oOfolola 
oe) apis lola 
aa) mpupophy 


ul 


As with DPBs, this happens with the help of a pointer which appears at the start 
of every buffer. Also, the last buffer is reached when the offset address of the 
pointer contains the value OFFFFH. After the field linking one buffer to the next 
comes the number of the drive where the buffered sector originates. The value 
would be 0 for drive A, 1 for B, 2 for C, etc. Besides the drive number, the 
identification of a sector requires a sector number. This is located beginning at 
position 06H in the DOS buffer. The last field in the buffer header stores a pointer 
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to the corresponding DPB, so that DOS can get information on the device which 
loaded the buffered sector. Although this is the last field in the header of the DOS 
buffer, the buffered sector does not end immediately after this field. There are two 
more bytes which follow. The reason for this is that the DOS code is written in 
machine language, and when it comes to working with memory blocks, it is most 
efficient to have the buffered sector begin with an address that is divisible by 16. 


The header of the DOS buffer is not the last place we run across the DPB. It turns 
up again in the path table, which starts at address 16H in the DIB. This contains 
the current path for each drive as well as a pointer to its DPB. 


0 12 3 4 5 6 7 8 9 ABC OD E F 
0000: 41 3A 5C 43 41 43 48 45-00 00 00 00 00 00 00 00 A:\CACHE........ 
0010: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 .........-. wee 
0020: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................ 
0030: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ..............-. 
0040: 00 00 00 00 40 20 74 80-02 27 03 FF FF FF FF 02 ....@ t..‘'...... 
0050: 00 42 3A 5C 00 00 00 00-00 00 00 00 00 00 00 00 .B:\..........6. 
0060: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................ 
0070: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ..............-. 
0080: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 .......... eee 
0090: 00 00 00 00 00 40 40 74-80 02 00 00 FF FF FF FF ..... COC ce cease 
OOAO: 02 00 43 3A SC 54 43 5C-42 41 55 53 5C 41 53 4D ..C:\TC\BAUS\ASM 
OOBO: 5C 48 45 52 43 4D 4F 4E-4F 00 00 00 00 00 00 00 \HERCMONO....... 
00co: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ................ 
0ODO: 00 00 00 00 00 O00 00 00-00 00 00 00 00 00 00 00 ............4.4. 
OOEO: 00 00 00 00 00 00 40 60-74 80 02 65 05 FF FF FF ...... @’ts.@v eee 
OOFO: FF 02 00 44 3A SC 4D 53-43 5C 42 49 4E 00 00 00 ...D:\MSC\BIN... 
0100: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ...............- 
0110: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 ........... 2 nee 
0120: 00 00 00 00 00 00 00 00-00 00 00 00 00 00 00 00 .........-. nae 
0130: 00 00 00 00 00 00 00 40-00 00 80 0D 17 00 FF FF. ....... Cra-ese eee 


Memory dump of the path table contents 


As long as the LASTDRIVE command is in the system's configuration file, the 
table will have entries for drives A through the one specified by LASTDRIVE. If 
this command is missing, however, the table will only have entries for each device 
supported by the installed device driver. If you change the entries in this table, you 
can divert one drive to another. The JOIN and SUBST DOS commands also take 
advantage of this by manipulating the path table entry of the drive to be diverted. 
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6.16 DOS 4.0 


People were rather surprised when IBM introduced DOS 4.0 instead of DOS 3.4. 
The version number suggests vast improvements to this operating system. 
Version 4.0 does in fact have some features to offer which clearly set it apart from 


its predecessors: 

° Full-screen system installation 

° Graphic user interfaces for directory display, file selection and running 
programs 

° Full mouse support 

° Support of Extended Memory Specification (EMS) according to the LIM 
4.0 specification for buffer storage 

° Hard disk partition (volume) support and support for device capacity larger 
than 32 megabytes 

° Improved file access through optimization of the system code 


The introduction of these features mean changes in the operating system code. 
Although most of these changes will not affect most application programs, they 
may cause problems in programs that lie within the system, as well as programs 
developed without following rules of compatibility (see Section 6.14). 


Compatibility problems 


First of all, the support of hard disk partitions and files larger than 32 megabytes 
implies definite changes to the DOS file system. These changes don't affect 
programs that manipulate files only through the DOS interrupt 21H functions. 
However, many block device drivers and programs that access the DOS structures 
of the file system directly will have to be adapted to the new file system. This 
includes programs like the Norton Utilities®, PC Tools® and all the other 
utilities which perform tasks such as optimizing hard disks and restoring lost files. 
All of these will be of little or no use under DOS Version 4.0. 


To give you a chance to adapt programs affected by these changes to DOS 4.0, the 
following pages give a description of changes to the file system (see Section 6.13 
for a comprehensive look at the DOS file system). 


In order to best visualize the changes to the file system, let's begin with a picture 
of its fundamental structure, which remains valid under Version 4.0. This 
fundamental structure can be divided into three layers, one on top of the other. 
These range from the logical partitioning of a mass storage device on the top layer 
to a purely physical system on the bottom layer. The top layer forms the function 
interface to user programs. This interface calls individual functions through 
interrupt 21H. No changes are allowed on this level in the switch to DOS 4.0 to 
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ensure that all applications that use these functions will continue to run normally. 
File accesses from the first level are converted to device driver function calls on the 
second level. In order to locate each file (i.e., retrieve the sectors which must be 
accessed) this level uses various data structures which are kept in the storage 
medium. These include: 


2 The boot sector (including the BIOS parameter block [BPB]) 
° The root directory and its subdirectories 
2 The FAT and its duplicates 


These functions cannot be changed as well, since one of the most important 
demands placed on the new DOS version is the ability to work with partitions that 
were created and formatted under previous versions. This is possible only if the 
structures listed above are not changed. This does not leave many ways to increase 
the capacity of a volume. Since the size of the FAT entry is limited to 16 bits, a 
volume can use no more than 65519 clusters. Therefore, an increase is possible 
only by using more sectors in a cluster. 


When DOS 4.0 sets up new partitions, it assigns the following cluster sizes: 


Partition and cluster sizes under DOS 4.0 | 
1028 _meg]2048_meg 


Secs. per cluster | 4 [8 | 16 | 32 


While this procedure minimizes the changes on the second level of the file system, 
it also has a disadvantage: The bigger the partition, the more memory it wastes. 
Since the memory in a partition can only be allocated in clusters, some memory is 
always wasted when a cluster is not completely filled. This is true of files that are 
smaller than the cluster size. Memory space is also wasted in the last cluster of a 
larger file, since the size of a file is rarely an integral multiple of the cluster size. 


driver level 


The changes become most noticeable on the third level of the file system, called 
the device driver level. While character drivers remain unaffected by changes in the 
partition size, these changes have a great impact on block drivers that support 
partitions of more than 32 megabytes. 


It's true that changes on this level could be kept to a minimum by increasing the 
sector size from 512 bytes, but this could lead to compatibility problems with 
partitions that were configured under previous versions of DOS. The only 
alternative was to increase the number of sectors per partition. But when a 
partition exceeds the 32-megabyte limit, the 16 bits, which up until now were 
used to store the logical sector number, are no longer enough. For this reason, 
DOS 4.0 has introduced a new type of block driver that supports partitions larger 
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than 32 megabytes, and works with 32-bit sector numbers. DOS recognizes these 
drivers with the help of bit 1 in the device attribute. This bit carried a value of 0 in 
previous versions of DOS. 


Starting with Version 4.0, DOS knows that it is dealing with a 32 bit driver if 
this bit is turned on. Increasing the sector number also changed the structure of the 
parameter data block, with which DOS passes information on the functions and 
parameters being called, to the device driver. Since a 16-bit field is no longer large 
enough for the sector number, DOS 4.0 adds a 32-bit field to the end of the block. 
This stores the sector number for a 32-bit driver as a dword (double word). As 
usual, the word with the smaller value is stored before that with the larger value. 
To indicate that the new field is in use, DOS also loads the value -1 (FFFFH) into 
the old field. 


Structure of the extended parameter data block when 
calling a function of a 32-bit driver under DOS 4.0 


1_byte 
1_byte 
L_byte | 
8 bytes 
Media descriptor | 
1_word 
[+14H | Number of first sector for 16 bit drivers | 1 word 
+16H | 


adword 


Number of first sector for 32 bit drivers _ 
Length: 1AH (26) bytes 


The following driver functions are affected by the change to 32-bit sector numbers: 


0 initialize driver 
Zz set BPB 

3 direct read 

4 read | 

8 write 

9 write and encode 
12 direct write 


The structure of the BIOS parameter block (BPB), which the initialize driver 
function must pass to DOS, has also changed. This structure is also part of the 
boot sector of a DOS volume. It has been supplemented by two fields compared to 
the old BPB, and now looks like this: 
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Extended BIOS parameter block (BPB) structure under DOS 4.0 


ddr. 
+02H 
+03H 


+05H Number of file allocation tables (FATs) 
+06H Number of entries in root director 


+08H Number of sectors in volume 
(partitions <= 32 MB only) 


+OAH Media descriptor 
+OBH Number of sectors per FAT 
+0DH 


+OFH Number of read/write heads 

+11H Distance of volume's first sector from first 
sector on medium (partitions <= 32 MB only) 
+13H Distance of first sector in volume from first ]|1 dword 
sector on medium (partitions > 32 MB only) 
+17H Number of sectors in volume 1 dword 
(partitions > 32 MB only) 
Length: 1BH (27) bytes 


ee Loe Goel Coot Geel Lo) 
Z1O l= lol= fo 
1?) (eo) Oo 10 
Kict ik ict In 
O70 110 FO. 


— 
= 
0 
ry 
Q. 


el Lonel Lonel Loe 
== [= [oO 
O FO FO 

Rin ES Ict 
2101010 


word 


| 


+02H | 
+03H | 
+05H | 
lal 
+OAH | 
+0BH 
[+ODH_| 
+OFH | 


The two new fields in this extended BPB refer to the total number of sectors in the 
volume and the number of sectors between the first sector on the storage medium 
and the first sector of the volume. Even though these fields were already present in 
the old BPB, they were there only as 16-bit values, and had to be appended as 32- 
bit fields. To guarantee maximum compatibility with the drivers of previous DOS 
versions, DOS only needs to use the new BPB when the sector numbers cannot be 
represented as 16-bit values. This happens if the distance from the first sector on 
the storage medium to the first sector in the volume is greater than 32 megabytes. 


The new BPB is installed while formatting a volume, but the old 16 bit fields are 
used to store the number of sectors and the distance from the first sector when the 
conditions mentioned above don't apply. Otherwise, the corresponding values are 
entered in the 32 bit fields and the 16 bit fields are assigned a value of 0. 


Extending the logical sector number to 32 bits also caused a change in the way the 
25H and 26H interrupt functions work. These functions represent the only way for 
an end-user program to directly access the individual sectors of a volume via DOS. 
If the number of the first sector to be processed was passed to the DX register of 
these interrupts by an earlier DOS version, direct sector access is only possible 
under Version 4.0 if the volume to be accessed is smaller than 32 megabytes. To 
access larger volumes in Version 4.0 and higher, the DS:BX register pair of these 
interrupts must receive a pointer to the data block pictured on the next page: 


Abacus 


6.16 DOS 4.0 


Structure of data block used in calling interrupts 
25H and 26H under DOS 4.0 


Number of first sector 
Number of sectors 
Pointer to buffer otr 


Length: OAH (10) bytes 


At the same time a value of -1 (FFFFH) must be passed to the CX register, so 
that DOS knows that the parameter transfer will not be following the old scheme. 
In conclusion, there is one more little innovation to mention. While this has no 
impact on program development under DOS 4.0, it does show that the 80386 has 
truly come of age. For example, 80386 PCs can use a particular trick to speed up 
file access and corresponding buffer and cache operations. DOS uses the 
capabilities of the 80386 very skillfully by running string instructions using 
bytes, words and dwords (double words). When copying and pushing memory 
blocks within the IO.SYS and MSDOS.SYS modules, the following code 
sequence is used to process the transcription in dwords: 


MOV CX, NUMBER ;load number of words to move 

SHR CX, 1 s;cut number of words to move in half 
DB 66h ;dword prefix for string command 

REP MOVSW ;copy memory block 


Since neither the 8088 nor the 80286 processors can perform dword operations, the 
SHR CX,1 and the DB 66H instructions are simply replaced with NOP 
instructions when installing the module, if the PC is equipped with a processor 
other than an 80386. 
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The BIOS 


BIOS is the abbreviation for Basic Input/Output System. The name indicates that 
the BIOS provides basic input and output routines for communicating between 
software and the hardware peripherals such as keyboard, screen and disk drive. 


Why the BIOS is important 


Since these routine calls are standardized, this saves the programmer the trouble of 
fitting programs to one particular PC hardware configuration. This means you can 
develop a program on one PC or compatible, and run it on another compatible PC 
without errors, even though neither the hardware nor the individual BIOS routines 
are completely compatible. This hardware independent concept contributed much to 
the popularity of the PC. It offers the computer manufacturers the ability to 
develop PCs which aren't quite identical to a true IBM PC, yet can run popular 


software. 


About BIOS functions 


BIOS functions occur through the individual routines contained in the BJOS 
interrupts 10H to 17H and 1AH. The processor registers, whose usage is also 
standardized, transfer data from the calling program to the interrupt and from the 
interrupt to the calling program. 


Number | Meaning 
10H IOS display function call 
Testing the configuration 


10H 
12H RAM 
14H 


| 


rF 
0) 
7) 
ct 
bh 
| 
Q 


BIOS disk functions 
14H Functions for asynchronous communication 


15H Cassette functions 


Reading the keyboard 
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BIOS architecture 
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The BIOS itself is located in PC ROM, making it resident even after the computer 
has been turned off. It is stored very high in the processor's address space 
beginning at address FO00:E000. It extends to address FO00:FFFF, the last 
location addressable on the Intel 8088 microprocessor. The BIOS routines must 
create, store and modify variables, much like any other routine. Since this is 
impossible in the BIOS area itself, BIOS stores these variables in the lower part of 
memory starting at address 0040:0000. 


This chapter begins with a description of the bootstrap, followed by descriptions of 
each BIOS function, call and application. 
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7.1 Booting the System 


Booting the System 


Section 6.3 described the booting process of DOS. The examination began at the 
point where the first sector of a diskette or hard disk loads into memory. From the 
time you switch on the computer to the booting process, a series of events occur. 
This section describes those interim events. 


Initialization 


Program execution in a computer based on the Intel 8088 (or one of its successors) 
starts after the computer is turned on at memory location FO00:FFFO. This 
memory location is part of the ROM-BIOS and contains a jump command to a 
BIOS routine which takes over system initialization. The location of this routine 
may differ from one computer to another (actually from BIOS to BIOS) because 
the BIOS changes internally with each manufacturer. The task this routine 
performs remains identical for nearly all PCs, however. 


System check 


First the BIOS tests individual functions of the processor, its registers and some 
instructions. If an error occurs during this test, the system stops without 
displaying an error message (this is impossible with a defective processor). If the 
CPU passes the test, a checksum is computed from each of the ROM's contents 
and compared with the various ROMs to determine whether a defect exists there. 
Each chip on the main circuit board (such as the 8259 interrupt, the 8237 DMA 
controller, and the RAM chips) goes through tests and initialization. 


Peripheral testing 


After determining the functionality of the main circuit board, the computer tests 
the peripherals (keyboard, disk drive, etc.). In addition to these hardware related 
tasks, the BIOS variables and the interrupt vector table must be initialized. 


The bootstrap loader 


Note that no mention has been made of the operating system so far. It hasn't been 
loaded into the computer from diskette or hard disk yet. Interrupt 19H, known as 
the bootstrap loader, performs this task on startup or on system reset (when you 
press the <Alt><Ctrl><Delete> key combination). This routine tries to load some 
form of the basic operating system from a predetermined place on the diskette. 


Reasons for failure 


This bootstrap process may fail for a number of reasons: 
° There is no disk in the disk drive. 
* There is a disk in the drive, but the disk isn't bootable (the DOS files are 


not available on the diskette). If this occurs, the bootstrap routine 


221 


7. The BIOS PC System Programming 


attempts to find the routine on the other disk drives connected to the PC, 
or on a predetermined location on an existing hard disk. 


If the system still cannot find the bootable system disk, there are two other reasons 
that may be causing a problem: 


° Some older systems switch to ROM BASIC. This is a small BASIC 
interpreter stored in PC ROM directly beneath the BIOS starting at 
memory location F000:6000. New PCs display a message on the screen 
requesting that the user insert a diskette containing the operating system 
into the drive. 


. BIOS doesn't care what operating system it loads, so it may attempt to 


load a non-DOS operating system if one exists on the disk. This makes it 
possible to load other operating systems such as XENIX. 
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Determining BIOS Version 


The previous section described memory location F0Q00:FFFO in conjunction with 
the system startup. Usually a 5-byte-long jump instruction can be found at this 
location. After this instruction, an additional 11 bytes are available (to 
FQO0:FFFF), which are normally used to store the release date of the BIOS 
version. 


You can examine the contents of these memory locations tc determine which 
BIOS version your PC uses. Call the DEBUG program from the DOS prompt: 


debug 
Enter the following line to display the bytes at the end of the ROM-BIOS: 


ad f000:fff0 1 10 


The next line displays the contents of this memory location as a hexadecimal 
number; the characters to the right of the hex display are the corresponding ASCII 
codes. Day, month and year appear as two digits separated by "/" characters. 


C>debug 
-d f000:fff0 1 10 
FOOO:FFFO EA 5B EO 00 FO 30 32 2F-30 36 2F 38 36 00 FC 00 {...02/06/86... 


-q 
C>_ 


BIOS date display in DEBUG 
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7.3 


Access 
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Determining the PC Type 


Usage of certain BIOS functions are more for model identification than for BIOS 
version identification. They indicate the type of PC in use. They also indicate 
when the BIOS has additional functions (e.g., AT BIOS is better equipped than the 
PC and XT BIOS). These extra functions essentially handle string output on the 
screen, realtime clock access (standard on the AT) and additional RAM beyond the 
1 megabyte memory limit (also standard on the AT). 


A program which calls these functions must first ensure that the computer in use 
is in fact an AT, and that the functions addressed are available. The programmer 
can use the model identification byte located in the last memory location of the 
ROM-BIOS at address FO00:FFFE. This byte can contain the following codes: 


252 or FCH: AT 
254 or FEH: XT and portable PC 
255 or FFH: PC 
Note: These values aren't entirely accurate. Many PC/XT compatibles 


indicate completely different values in the model identification byte. 
The following rule of thumb may be used: A model identification 
byte of 252 identifies an AT; any other number indicates a PC/XT. 


Only IBM computers have guaranteed reliable model identification numbers at 
memory location FOOO:FFFE. This may not be the case for compatible 
computers. Use the DOS program DEBUG to obtain the model identification byte. 
Call DEBUG with 


debug 


Enter the following command sequence: 


ad £000:fffe 11 
The model identification appears as a hexadecimal number on the screen. 
to the model identification byte from programs 


The model identification can be obtained directly from a program. Here's a short 
assembler program to perform that task: 


IDSeg segment at f000h 
org Offfeh 
PcID db (?) 
IDSeg ends 


push ds zstore data segment 
mov ax, IDSeg 
mov ds,ax ;set Data segment to BIOS 
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cmp PcID,252 ztest if AT-Code 
pop ds ;restore Data segment 
je IstAT 


s;Device is a PC/XT 


IstAT label near 


Higher level languages can also find the identification byte. The following BASIC 
program uses the PEEK statement for reading the model identification. 


10 def seg = &hF000 
20 if peek (&hFFFE) = 252 then print “AT" else print “PC/XT" 


Turbo Pascal uses the mem array to read the model identification: 


begin 
if mem[$FO00O : SFFFE] = 252 then writeln('AT') 
else writeln('PC/XT'); 
end; 


How the model identification is used in a program will be demonstrated in the 
programs later in this chapter. 
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7.4 BIOS Screen Output Functions 


The BIOS contains a series of routines which display data on the screen and 
maintain other display functions. In addition to the video mode, BIOS manages 
Cursor positioning, text output and graphic display routines. Interrupt 10H calls all 
these routines. The processor registers transfer the data between the application 
program and the BIOS interrupt routine. 


Under DOS versions 1.0 and 1.1, these BIOS routines were the only options for 
cursor positioning and color choice. DOS Versions 2.0 and up make these 
functions available under DOS as well. 


More about compatibility 


The BIOS routines execute faster than their corresponding DOS routines. Those 
concerned about compatibility and output device redirection may be better off using 
DOS routines. In any case, the application itself should dictate which routines will 
be used. 


The BIOS routines, like the DOS routines, offer the programmer the advantage of 
independence from a particular video card (IBM monochrome, IBM color, Hercules, 
etc.), since they can be adapted to various cards. Because these cards have different 
features supported by BIOS, let's look at the capabilities of these cards before 
examining the routines of interrupt 10H. Programs demonstrating the function 
calls are listed in BASIC, Turbo Pascal, C and assembly language later in this 
chapter. 


Monochrome display adapter 
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This card displays a page of 25 lines and 80 columns. Column 0 and line 0 are in 
the upper left hand corner of the display. The numbering continues to the right and 
down from column 0, line 0. 
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ROWS COLUMNS 


76 #77 78 79 


22 


23 


24 


Line and column numbering—monochrome display 


Each of the 2000 (80*25) positions on the screen is represented by a character from 
a set of 256 characters (IBM PC standard character set) and an attribute character, 
also called an attribute byte. Both characters require one byte apiece, so 2000*2 
(4000 bytes) of video RAM must be available to display the entire screen. This 
video RAM exists on the video display card. Since video RAM is not part of the 
normal RAM, the starting address remains constant at address BO0O:0000 for the 
monochrome card. 


While the PC systems have standard character sets for all the video cards described 
here, the attribute bytes change from card to card. 


As the figure below shows, bits 0 to 2 and 4 to 6 of the attribute byte defines the 
foreground and background color of the displayed character. 
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Character color 


Character intensity 
0 = normal,1 = high 


Background color 


Blinking 
0 = off,1 = on 


Attribute byte color structure—monochrome display adapter 


Bit 3 of the attribute byte indicates the intensity of the foreground color. If it 
contains a 1, the character appears in high intensity. Bit 8 indicates whether the 
character on the screen should blink (a 1 in this bit causes the character to blink). 
While these bits can be set in any manner, only bit combinations which "look 
good" should be used for foreground and background color. 


7 


No characters 
(black on black) 


Underlined characters 
Normal characters 
(white on black) 


Inverse characters 
(black on white) 


White character field 
(white on white) 


Colors and attribute byte—monochrome display adapter 


Color graphics adapter (CGA) 
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This card offers text display of the IBM PC standard character set and various 
graphic modes. Text mode works with a resolution of either 80x25 or 40x25 
characters. 40x25 resolution displays characters in double width. This mode allows 
the management of up to eight different video pages (80x25 mode allows up to 
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four different pages). The line and column number assignment is similar to the 
monochrome display card. 


CGA attribute bytes 


The attribute byte used on this card mainly selects foreground and background 
colors of the characters. A total of 16 colors is available. The first eight of these 
may be used as background colors. 


HOR 231 

Green 
ae | 
eed 


FES aa ce ver eee 
Magenta 
16 | Brown (dark yellow on some monitors) | 
7 
11000(b) [8 | Dark Gray (or black) 
a ETS ee ee ee 


As the figure below shows, bits 0 to 3 of the attribute bytes represent the 
foreground color, while bits 4 to 6 indicate the background color. Bit 7 means the 
same as in the monochrome display card: it decides whether the character should 
blink. 


Character color 
Background color 


Blinking 
0 = Off,1 = on 


Attribute byte structure—color graphic adapter 
This card can emulate a monochrome display card (see above) in which the 


attribute character has the same meaning as in the monochrome card, with the 
exception that no underlined characters can be produced. 
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Graphic modes and the CGA 


Graphic modes can have either a resolution of 640x200 dots with 2 colors or 
320x200 dots with 4 colors. In both modes the upper left corner of the screen has 
the coordinates 0/0. 


No attribute byte exists in this mode since every dot on the display is either 
illuminated with a color or not, and not composed of standard characters from a 
character set. To display characters from the standard character set in this mode, 
they must be drawn on the screen with pixels (dots). 


In 320x200 resolution, one of the 16 available colors can be defined as a 
background color. The foreground color must be one of three colors in a palette 
predetermined by the graphic card. Two palettes are normally available: One 
contains the colors cyan, magenta and white, while the other offers the colors 
green, red and yellow. 


The video RAM of this card starts at location B800:0000 (unlike the monochrome 
display card which starts at BO00:0000). This ensures that the video RAMs of the 
two cards do not overlap. They can be used in parallel with each displaying data on 
its own monitor. 


Hercules graphic cards 
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The Hercules graphic card has the same text mode as the IBM monochrome display 
adapter, and can display two video pages of text at a time. A Hercules card also 
offers a graphic mode in which two video pages can be displayed with a resolution 
of 720x348 pixels. Unfortunately, the BIOS cannot access either the two video 
pages or the graphic mode. BIOS treats this card like a normal monochrome card, 
which can only display one text page of 80x25 characters. 


Now that you have some general knowledge of graphic adapters, here are the 
functions called from interrupt 10H: 


Determine color palette for graphic mode | 
Set display point in graphic mode | 


Sense display point in graphic mode 
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Character output (like a terminal) 
Determine video mode 


Write character string 


available on AT) 


(onl 


As always, the processor registers pass the function arguments. Some common 
rules define which registers accept which arguments: 


The AH register indicates the number of the function to be called with interrupt 
10H. If character should be displayed, or a dot placed on the screen in graphic 
mode, its value passes to the AL register. 


Hercules functions 


If the function expects display coordinates for text mode, the X-coordinate 
(column) must be loaded into the DL and the Y-coordinate (line) into the DH 
register. In graphic mode the CX register accepts the X-coordinate and the DX 
register the Y-coordinate. The number of the display page (if required) should be 
contained in the BH register. 


It is important for assembler programmers that the contents of the BX, CX, DX 
and the contents of the segment registers remain the same before and after the 
interrupt call. The contents of all other registers may change. 


Function OH: Set video mode 


Before sending output to the screen, the video mode must be selected. The current 
video mode in use might not be the one you desire. Function 0 of interrupt 10H 
performs this task and also selects the active video card in case the PC has several 
video cards connected. For a call to this function through interrupt 10H, the AH 
register must contain function number O and the AL register must contain the 
number of the video mode to be activated. Of course only those video modes that 
are supported by the video card in the PC can be activated. The following numbers 
correspond to the various video modes (the video card supporting the mode is in 
parentheses): 


40*25 character monochrome text displa (Color) 
sl 40*25 character color text displa (Color) 


80*25 character monochrome text display. 
80*25 character color text displa (Color) 
320*200 pixel graphics with 4 colors (Color) 


5 | 320*200 pixel graphics with 4 colors (Color) 
but shown monochrome 


640*200 pixel graphics with 2 colors (Color) | 


The mode makes no difference on a monochrome card, since only one mode exists 
(80x25); this mode is constantly active. It uses the internal designation number of 
7. 
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Function OFH: Get video mode 


The opposite of this function is function OFH, which determines the current video 
mode. A value of OFH in the AH register during a call to interrupt 10H executes 
this function. It returns the value of the video mode (refer to the table above) in the 
AL register. As mentioned above, a monochrome card always returns the value 7. 
Besides the video mode, the number of columns per display line in this mode (40 
or 80) returns in the AH register and the current display page number in the BH 
register. 


Function 02H: Set cursor position 


After the video mode initialization, screen output can begin. Function 2 defines the 
cursor position. Calling this function places the blinking cursor in the desired 
location on the screen. This sets the starting position of character display. Prior to 
calling this function the AH register should be loaded with the function number 
(2), the DH register with the line location of the cursor, and the DL register with 
the column location of the cursor. The BH register holds the display page onto 
which the cursor should be positioned. Remember that every display page has its 
own cursor for positioning the text output, but only one active or blinking display 
cursor exists. This active cursor always appears on the currently displayed page. 
Function 2 moves the active cursor if the value in the BH register corresponds to 
the current screen page. 


Function 03H: Read cursor position 
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The counterpart of this function is function 03H. It reads the current cursor 
position of a selected display page and returns the position to the calling program. 
At the call of this function the AL register must contain the function number (3) 
and the BH register the number of the display page whose cursor position is being 
read. 


Monochrome display cards return a value of 0, since the card can only display one 
page (numbered 0). After the call of interrupt 10H the DH register contains the 
Cursor position's line and the DL register the cursor position's column. In addition, 
two values are returned to the CH and CL registers which have special 
significance. They indicate the starting and ending raster scan (pixel) lines of the 
cursor. These lines are independent of the displayed page. 


To understand this significance, it is important to know that every text mode 
character on color and monochrome cards have heights of 8 and 14 pixels per 
character, respectively. The programmer can choose at which of these pixel lines 
the blinking cursor begins and at which it stops. 
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These values must of course remain within the legal values of the individual video 
cards (i.e., 0 to 7 for a color card and 0 to 13 for a monochrome card), otherwise 
the blinking text cursor may disappear from the screen. 


Function 01H: Define cursor size 


While these values are read with the help of function 3, function 1 is used to set 
these values. The AH register loads with a 1, the CH register with the starting line 
of the cursor, and the CL register with the ending line of the cursor, before calling 
interrupt 10H. The starting line must be smaller than or equal to the ending line, 
or the cursor becomes invisible. 


Function 05H: Set active display page 


This book has frequently mentioned the current display page without telling how 
to activate this page. Function 05H of interrupt 10H performs this task. Place a 
value of 5 in the AH register and the number of the page you want activated 
(displayed on the monitor) in the AL register. The number of the page to activate 
depends on how many pages are available in the current video card and video mode. 
Since the monochrome video card offers only one display page, using this function 
with a monochrome card makes no sense at all. The following values are allowed 
for the color card's different video modes: 


0 to 7 (40*25 character text display [Color-card])} 
0 to 3 (80*25 character text display [Color-Card]) 


After selecting the video mode and moving the cursor to the desired location on the 
screen, one or more characters are output on the screen in most cases. BIOS makes 
various functions available which have different abilities in providing character 
display on the screen. One difference between these functions is that they process 
control codes in various ways. These control codes are the ASCII codes 7, 8, 10 
and 13. They represent the following: 


ec 
cursor back one character position 

10 

Carriage return 


Some functions view these codes as normal ASCII characters and execute them 
accordingly. Other functions see them as control codes. For example, code 7 
produces a sound with some functions. The choice of which function to use 
depends on which control code processing is desired. 


Text display in graphic mode 


Text display functions can be used in both text and graphic modes. Text output in 
graphic mode creates different characters since the characters must be drawn on the 
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screen from pixels. The PC uses ASCII codes to set the graphic pixels. While the 
character samples for the ASCII codes 0 to 127 are already stored in the ROM, the 
character patterns for the codes 128 to 255 must be read from a table in RAM. 
This table installs itself in RAM when ye execute the DOS GRAFTABL 
command. 


BIOS obtains the address of this table from the memory locations 0000:007C to 
0000:007F, where the table's offset address lies in the lower two bytes and the 
table's segment address in the upper two bytes. These memory locations are inside 


- the interrupt vector table but can be used for this purpose since nee 1FH 


(whose address normally appears there) remains unused. 


Having this table stored in RAM makes it possible to define your own table, sO 
that special characters which are not contained in the standard character set can be 
displayed on the screen. Since every character is comprised of 8 bytes, the first 8 
bytes of the table are reserved for ASCII code 128, the next 8 for the code 129, etc. 
Each byte contains the bit pattern for one of the 8 lines which compose a 
character. Bit 0 represents the dot on the right border of the character matrix, bit 7 
the dot on the left border. If you set a bit to 1, this illuminates the corresponding 
pixel on the screen. 


Function O9H: Write character with attribute 
Function OAH: Write character 


Functions 09H and OAH are available for character output. Function OAH displays 
the character in the color determined oy the attribute corresponding to that 
particular screen position. Function 09H sets the color (attribute) of the character 
to be displayed. Neither function moves the cursor to the next screen position after 
character display. Character output resumes at the same location on the next 
function call. Function 02H must be called to move the cursor to the next screen 
position for displaying readable text. 


Determiiuing the function call 
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Both functions 09H and OAH interpret the control codes described above as normal 
characters and display them accordingly. During the call of these functions the 
contents of the AH register depend on whether the user called function 09H and 
OAH. The AL register accepts the ASCII code of the character to be displayed. The 
display page for character display can be found in the BH register. The CX register 
contains a number which indicates how many times the character should be 
displayed. Because of this, it's possible to display a character several times with 
Just one interrupt call (this saves time and memory). If you want the character in 
the AL register displayed only once, a 1 must be stored in the CX register during 
the function call. Since function 09H also determines the color of the character to 


, be output, the BL register passes the character color. 
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Function OEH: Teletype mode 


A serious disadvantage of these two functions is that the cursor's position does not 
advance after the function call. Function OEH cures this problem. It acts like a 
terminal, hence its name—the TTY (Teletype output) routine. The cursor advances 
to the next screen position after a character is displayed. If the cursor reaches the 
end of the screen line, it moves to the beginning of the following line. If the 
cursor is in the last display screen position (line 24, column 79), the entire screen 
is scrolled one line upward and the top line of the screen disappears from the 
display area. In addition, the function clears line 24 and the cursor moves to the 
beginning of the line. 


Another approach to control codes 


Unlike functions 09H and OAH, function OEH treats control codes according to 
their functions, and not as normal ASCII codes. Like function OAH, characters are 
displayed by function OEH using the character color (attribute) already present at 
that screen location. This is valid for text mode only. In graphic mode, the 
foreground color must be passed in the BL register. 


Prior to the function call, the AH register must be loaded with function number 
OEH, the AL register loaded with the code of the character to be displayed and the 
BH register with the display page intended for character display. 


Function O8H: Read character/attribute 


While functions 09H, OAH and OEH display characters on the screen, function 08H 
makes it possible to read characters from the screen, 1.e., to sense the character and 
attribute displayed. Before the call, the value 08 must be loaded into the AH 
register and the number of the display page from which the character should be 
loaded into the BH register. The display position from which the character should 
be read is the current cursor position in the display page indicated by the BH 
register. 


In text mode the character code can be read directly from video RAM. However, 
graphic mode requires a comparison between the bit pattern at the current cursor 
position and every character's bit pattern in the character set. 


After the function call, the AH register contains the attribute (color) and the AL 
register contains the ASCII code of the character read. 


Function 06H: Scroll window up 


Function 06H scrolls the screen up one or more lines, or clears sections of the 
screen by displaying spaces (ASCII code 32). These operations can only be 
performed on the current display page. To call this function, you must load the AH 
register with the function number (6). The AL register is loaded with the number 
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of lines the display should be moved up. A 0 in this register instructs the function 
to fill the screen area with spaces instead of scrolling the screen. The BH register 
contains the color (attribute) for the blank line. The CH, CL, DH and DL registers 
define the display page window to be scrolled or cleared. The C register represents 
the upper left corner of the window, while the D register defines the lower right 
corner of the window. The following list illustrates the meaning of each register: 


Regs | Meaning. 
Line of the upper left corner of the window 


icL Column of the upper left corner of the window 


Line of the lower right corner of the window 
Column of the lower right corner of the window. 


Function 07H: Scroll window down 
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Function 07H scrolls the screen down one or more lines, or clears sections of the 
screen by displaying spaces (ASCII code 32). These operations can only be 
performed on the current display page. To call this function, you must load the AH 
register with the function number (7). The AL register is loaded with the number 
of lines the display should be moved down. A 0 in this register instructs the func- 
tion to fill the screen area with spaces instead of scrolling the screen. The BH 
register contains the color (attribute) for the blank line. The CH, CL, DH and DL 
registers define the display page window to be scrolled or cleared. The C register 
represents the upper left corner of the window, while the D register defines the 
lower right corner of the window. The following list illustrates the meaning of 
each register: 


Reg | Meaning 
3 | 


Meaning 


Line of the lower right corner of the window . : 
Column of the lower right corner of the window 
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Graphic functions 


The following are descriptions of the functions used in the different graphic modes. 
They can be used in connection with video cards capable of producing graphics. 


Function OOH: Set video mode 


Function 00H switches on one of the available graphic modes. The border color (or 
color palette) should then be selected for the 320x200 (or text) mode by loading 
function number OAH in the AH register. The BH register dictates the use of the 
border color or the color palette. If during the function call the BH register contains 
a 0, the value in the BL register becomes the background and border color for the 
graphic mode. All 16 colors are available, so the BL register can contain a value 
between 0 and 15. This function remains valid for the text mode. However, only 
the border color can be set. The background color for each character is set 
individually by the top 4 bits of the color attribute, and therefore cannot be set for 


everything. 


If the BH register contains a 1, the value in the BL register (0 or 1) selects the 
active color palette. The palettes contain the following colors: 


. Green, red, yellow 
Cyan, magenta, white 


Function OBH: Set color palette 


Once the graphic mode initializes and the colors are selected, graphic drawing can 
begin. Function OBH writes graphic pixels at specified locations of the screen. The 
pixel coordinates to be addressed are passed in the CX and DX registers. The values 
in these registers depend on the graphic resolution of the current graphic mode. The 
CX register contains the X-coordinate (column coordinate) of the pixel, and the DX 
register the Y-coordinate (line coordinate) of the pixel. The function call must have 
the function number (OBH) passed in the AH register. The color value of the pixel 
to be manipulated is passed in the AL register. The Hercules card and the 640x200 
mode of the color card permit the values 0 and 1 only. In the 320x200 mode of the 
color card, the values 0 to 3 are allowed for the 4 possible colors. The significance 
of these values depends on the active color palette. If a program enables palette 0, 
the values have the following significance: 


[Oi Color selected _for background with function OBH 
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An active palette 1 changes the values slightly: 


los Color selected for background with function OBH 
Cyan 
Magenta 


White 


Function ODH: Read pixel 


Function ODH is the equivalent of this function, which determines the color value 
of a pixel. Before the call, the value ODH must be passed in the AH register, the 
X-coordinates of the pixel must be loaded into the CX register, and the Y- 
coordinates into the DX register. The pixel color is returned as a result in the AL 
register. This value corresponds to the rules described in function OBH. 


Function 13H: Write string 
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Interrupt 10H includes another function on AT computers. Function 13H displays 
strings of characters on the screen. During its call a series of arguments must be 
passed, in addition to passing the function number to the AH register. The BH 
register accepts the number of the display page on which the string should be 
displayed (not necessarily the current display page). The starting position of the 
character string on the display is in the DH (line) register and the DL register 
(column). The CX register contains the number of characters in the character 


‘String. 


The AL register's contents define one of the four possible modes in which the 
character string can be displayed. The string format in modes 0 and 1 differ from 
string format in modes 2 and 3. Modes 2 and 3 place attribute bytes after every 
character in the string. In modes 0 and 1, the individual characters of the string 
follow one another in sequence. The attribute byte for all characters depends on the 
contents of the BL register. In modes 2 and 3, 2 bytes are stored in the string for 
every character displayed. For example, a character string of 4 characters requires 8 
bytes of memory. The number of characters to be displayed (4 characters in this 
example) must be indicated in the CX register. Another difference between modes 0 
and 2 and modes 1 and 3 is in display format. After the string display in modes 1 
and 3, the cursor appears following the last character of the string. The next 
character displayed with one of the BIOS functions then appears at this position on 
the screen. The cursor position does not get updated in modes 0 and 2. 
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Demonstration programs 


The following programs demonstrate the use of BIOS video interrupt functions 
available from higher level languages. In Pascal and C, you'll find that using BIOS 
display functions works much faster than the standard procedures and functions 
provided in these languages, which use the slower DOS functions. BASIC’s use of 
BIOS screen functions is minimal, since these functions are even slower than the 
BASIC PRINT statement. 


Advantage 


Accessing BIOS video interrupt functions has an advantage over the use of onboard 
graphic commands in higher level languages: the BIOS functions can be accessed 
at any time. 


Disadvantage 


There is a serious disadvantage to using BIOS functions for screen output. The 
higher level language display commands can accept numerical variables, which are 
then converted to ASCII characters. These higher level commands can format the 
variables according to decimal places or a certain degree of precision, then display 
these variables. However, if numerical variables are to be displayed using the BIOS 
functions, they must first be converted into a character string which you must 
transfer to the BIOS output function. This procedure takes time. 


All three programs are identical in function. Each fills the screen with continuous 
characters from the PC character set, then opens two windows in which two arrows 
move up and down. How this was done, and how it will actually appear on the 
screen, should become clear after you take a closer look at the program codes. The 
programs limit their access to one video page, due to incompatibility problems 
that could occur between monochrome and color cards. They also do not present 
subroutines, functions or procedures for calling the BIOS graphic functions. 


Once you understand this section you should be able to easily add the missing 
functions and even write a short demo program of your own. Using BIOS video 
interrupt assures that the computer will not crash and that nothing major can go 
wrong. 


BASIC listing: VIDEOB.BAS 


LOG PERAK KAKEKKKKKKKK KEKE KEKR KEK KKEKKEKKKEEKRKKKKEKEKEKREKKEKKKEKKKKKKEKKKKES 


110) ** VIDEOB BAS *! 
120 WIE oo ss se ee Ses i cle cs is Sem ss es dh Se Sets ses eet es asc eats ae tn ns Gem esc eens st east in sine een encore ss as fn ml Sch Sih ams noes ‘nn eins Mls eh ces law Sno’ xe 
130 '* Task : Makes some Subroutines available for access x 
140 '* to the Display using the BIOS-Video-Interrupt *' 
150 *'* x 
160 '* Author : MICHAEL TISCHER = 
170 ‘* developed on : 07/18/87 x 
180 '* last Update =: 05/14/89 x? 


190 CRKKKKKKKKKKEKEKEKKKEKKKKEKKKKEKEEKEKKKKKKEKKKKKKKEKKKEKEKKKKKKKKKKKKKKE 
200 § 

210 CLS : KEY OFF 

220 PRINT"WARNING: This Program should only be started if GWBASIC was " 
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230 PRINT"started from the DOS level with 


<GWBASIC /m:60000>. ™ 


240 PRINT : PRINT“If this was not the case enter <s> for Stop." 


250 PRINT“Otherwise press any key..."; 
260 AS = INKEYS : IF AS = “s" THEN END 


270 IF AS = “" THEN 260 

280 CLS 

290 GOSUB 60000 

300 PAGE%=0 ‘Display 
310 COLRR%=7 ‘light 


320 FOR DISPROW%=1 TO 24 
330 FOR DISPCOL%=0 TO 79 


‘Install function for interrupt call 


page for the output is Page 0 
characters on dark background 
‘process all display lines 
‘process all display columns 


340 CHARACTERS=CHRS ( (DISPCOL%$+DISPROW%*80) AND 255) ‘continuous code 
350 GOSUB 52000 ‘Set cursor position 
360 GOSUB 57000 ‘Output character 
370 NEXT ‘next column 
380 NEXT ‘next line 


390 VALUE%=0 

400 ULC%=5 : ULR%=8 : LRC%=19 : LLR%&=22 

410 GOSUB 55000 

420 ULC%=60 : ULR%=2 : LRC%=74 : LLR%=16 
430 GOSUB 55000 

440 COLRR%=&H70 

450 DISPCOL%S=5 : DISPROW%=8 

460 TS=" Window 1 " 

470 GOSUB 58000 

480 DISPCOL%=60 : DISPROW%=2 
490 TS=" Window 2 “ 

500 GOSUB 58000 

510 DISPROW%=0 : DISPCOL%=0 

520 TS=STRINGS (23," ")+"Arrow number is 
530 GOSUB 58000 

540 COLRR$=&HFO ‘dark chars on light 
550 DISPCOL%$=24 : DISPROW%=12 

560 TS="_>>> PC SYSTEM PROGRAMMING <<< " 

570 GOSUB 58000 

580 VALUE%=1 

590 FOR ARROWS%=4 TO O STEP -1 

600 DISPCOL%=35: DISPROW%=0 

610 COLRR%$=&H70 ‘dark characters 
620 TS=STRS (ARROWS$) 

630 GOSUB 58000 

640 COLRR%$=7 

650 FOR COUNTL%=1 TO 8 


‘dark letters 


‘light 


‘Erase Window 

‘Coordinates of the 1. Window 
‘Erase Window 

‘Coordinates of the 2. Window 
‘Erase Window 

on light background (inverse) 
‘Coordinates for Text output 
‘Text for output 

‘Output Text 

‘Coordinates for text output 
‘Text for output 

‘Output Text 

‘upper left Display corner 
being drawn "+STRINGS (23," ") 
‘Output Text 

background (inverse) blinking 
‘Coordinates for Text output 
‘Text for output 

‘Output Text 

‘always scroll one line 
‘Output total of 10 Arrows 


‘Position for number of Arrows 


on light background (inverse) 


‘Convert number of Arrows into ASCII-String 


‘Output Text 
characters on dark background 
‘an Arrow consists of 8 Lines 


660 DISPCOL%$=5 : DISPROW%=9 ‘Coordinates in first Window 
670 TS=STRINGS (8-COUNTL$," ") +STRINGS (2*COUNTLS$-1, "*") +STRINGS (8-COUNTLE," ") 
680 GOSUB 58000 ‘Output Arrow line 
690 DISPCOL%=60 : DISPROW%=16 ‘Coordinates in second Window 
700 GOSUB 58000 ‘Output arrow line 
710 ULC%=5 : ULR$=9 : LRC%=19: LLR%=22 ‘Coordinates of 1. Window 


720 VALUE%=1 ‘scroll one DISPROW 
730 GOSUB 56000 ‘Scroll Window down 
740 YJLC%=60 : ULR%=3 : LRC%=74: LLRt=16 ‘Coordinates of 2. Window 
750 VALUES=1 ‘Scroll one Line 
760 GOSUB 55000 ‘Scroll Window up 
770 NEXT ‘next Arrow Line 
780 NEXT ‘next Arrow 
790 CLS 

800 KEY ON 

810 END 

820 ! 

50000 CHK KK KKKKKKKKKKKKKKIKKKEKKKKKKKKKKKKEKEKKKKKEKKKEKKEKKEEKKKEKKKKEKKKKEKS 
50010 '* Sense Video mode and other Parameters ns 
50020 ! *----- ne  en rrnne xs 


50030 '* Input : none 


* 


50040 '* Output : VMODE% = the current Video mode = 
50050 ‘* PAGES = the current Display page m3 
50060 ‘* DISPCOL% = the number of Columns per Line = 
50070 '* Info : the Variable Z% is used as Dummy os 


50080 UR AKRK KKH KKEKKKKKRKKKAKKEKAKKAEK KER KKKKRKKKKKRKKKKAKKREKEKKKEKKKEKKKEK 


50090 ! 
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50100 DISPCOL%=15 ‘Get Function number for Video mode 
50110 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
50120 CALL IA(INR%, DISPCOL%, VMODE%, PAGES, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%) 
50130 RETURN ‘back to caller 
50140 ! 

51000 OHHH KKK KKK KKK KKK KKK KH KEK RK KKK KEK KKKKKKKKEAKKKKKKEEEKEKEKK 
51010 '* Define appearance of blinking Text-Cursor mA 
51020 8 % mn a rr rrr a 
51030 '* Input : BEGLIN% = is the beginning Line of the Text-Cursor *' 
51040 ‘* ENDL% = is the End Line of the Text-Cursor xs 
51050 '* Output: none ae 
51060 '* Info : the Variable 2% is used as Dummy x 
CaO Te CPE REE aaah kek Keke KeKkkkKk kk kkk KkkkKkK I 
51080 ! 

51090 FKT$=1 ‘Set Function number for appearance of Cursor 
51100 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
51110 CALL IA(INR%, FKT%, 2%, 2%, 2%, BEGLIN%, ENDL%, 2%, 2%, 2%, 2%, 2%, 2%) 

51120 RETURN ‘back to caller 
51130 ! : 
52000 CK KK AK KK KKK KKH KK KKK KKK KEK KEK KEKE KKKKEKKKEKEKEKKEKKEKEKKKKKKEKKKKEKKEKK! 
52010 '* Set Cursor Position a 
52020 ! *---------- $n nn rrr ne lie 
52030 ** Input : PAGE% = is the Number of the Display page a 
52040 ‘** DISPCOL% = is the new Column of the Cursor we 
52050 ‘* DISPROW% = is the new Row of the Cursor iat 
52060 '* Output : none WS 
52070 '* Info : The position of the blinking Text-Cursor is only ae 
52080 '* influenced by the call of this subroutine if the x 
52090 '* Display page indicated is the current Display page *' 
52100 '% = 
52110 ** the Variable 2% is used as Dummy = 
52120 OM KKK KAKEKKEKEKEKKKEAEKAEKEKEKKIEKKKKKK KIKI KKEKKREKKKKIHAKEKKKAKKEKS 
52130 ! 

52140 FKT%$=2 ‘Set Function number for Cursor position 
52150 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
52160 CALL IA(INR%&, FKT%, Z%, PAGES, Z%, 2%, 2&6, DISPROW%, DISPCOLS, 2%, 2%, 2%, Z%) 
52170 RETURN ‘back to caller 
52180 ! 

53000 BRAK KH KI KKK IKK IKK KKK RHE KKK KKK KK KKK KEKE KEKE KKKKAKS 
53010 '* Read Cursor Position and Beginning and End Row x" 
53020 ‘** of the blinking Text-Cursor ~ 
53030 '*---------~--~--+-~+--~~--~----- —- +--+ - - - - - $e eee * 
53040 '* Input : PAGE% = is the Number of the Display page ~e 
93050 ‘* Output: DISPCOL% = Column of the Cursor in the Display page *' 
53060 ‘* DISPROW% = Row of the Cursor in the Display page x" 
53070 ‘* BEGLIN$ = beginning Line of the Text-Cursor x 
53080 '* ENDL% = is the End Line of the Text-Cursor RY. 
93090 '* Info : the Variable 2% is used as Dummy an 
53100 CRKKKKKEKKKKKEKKKKKKKKKRKKKKEKKKK KEKE KKKKKKEKAEKEKAEKKKKKKKKEEKKKAKK KK 
53110 FKT%=3 ‘Read Function number for Cursor position 
53120 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
53130 CALL IA(INR%, FKT%, 2%, PAGES, 2%, BEGLIN%, ENDL%, DISPROW%, DISPCOL%, 2%, 2%, 2%, 2%) 
93140 RETURN ‘back to caller 
S250: 

54000 VR KRKKKKKKKKKKKKEKKKKKKK KKK KKK KKKEKKKKEKKKKKEKKEKKKEKEKKEKKKKKKKEKKEKKKKKEKS 
94010 '* Set the current display page on the = 
94020 ‘* screen ms 
54030 '*~-----------~~----~---------+----------- -------- ----- -- + ------ ++ - xt 
94040 '* Input : PAGES = is the Number of the Display page 7 
54050 '* Output: none * 
54060 '* Info : the Variable 2% is used as Dummy ies 
54070 DWH KKKRKEKEKKKKEEKKKKKKK KKK KK KK KK KKK KKK KKKKEKKKKEKKKKKKKKKEKEKEKEKS 
54080 FKT%=5 ‘Set Function number for Display page 
594090 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
54100 CALL IA({INR%, FKT%, PAGES, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%) 

54110 RETURN ‘back to caller 
54120 ' 

55000 CRE KKEKKKEKKK KK KKK KKK KKK KKKEKKKKKKKEKKKEKKKEKKKKEKEKKEEKEKKKKKEKEKE 
595010 '* Scroll current Display page up or erase sag 
55020 '*------------------~-----------~------------- ----- + -- - +--+ xe 
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55030 '* Input : VALUES = how many Lines to scroll = 
55040 '* ULC% = Column upper left —” 
55050 '* ULR% = Row upper left ws 
55060 ‘* LRC% = Column lower right w 
55070 ‘* LLR& = Row lower right = 
55080 '* COLRR& = COLRR of erased Lines ns 
55090 '* Output: none = 
55100 '* Info : If VALUE% 0 is indicated, the we 
99120° “* Display area is erased ate 
55120 '* the Variable 2% is used as Dummy x 
55130 CK KK AKKEKAKKKAEKEKKKKEKKKEKEKKKEKKKKKKKEKEKKAKEKKKEKEKEKEKEKKKEKKES 
55140 ! 

55150 FKT%=6 ‘Function number for scrolling up 
55160 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
55170 CALL IA (INR%, FKT%, VALUE%, COLRR%, 2%, ULR%&, ULC%, LLR&, LRC%&, 2%, 2%, 2%, 2%) 
55180 RETURN ‘back to caller 
95190 § 

56000 CK KKK KKK KKK MK KAKA KHER K KK KKKAKKKKKKKK KKK KKK KKKKKKAKKKEAKKKEK 
96010 '* Scroll current Display Page down or erase = 
96020 | 8am nn nn nn rn ene Sere ile 
56030 '* Input : VALUES = how many Lines to scroll li 
56040 '* ULC% = Column upper left mS 
56050 ‘* ULR% = Row upper left le 
56060 ‘* LRC% = Column lower right ake 
56070 ‘* LLR%& = Row lower right me 
56080 '* COLRR& = COLRR of erased Lines —s 
56090 '* Output: none a 
56100 '* Info : If VALUE% 0 is indicated, the “ 
56110 '* Display area is erased ‘a 
56120 °* The Variable Z% is used as Dummy 4 
56130 CKKKKKKEKKEKKK KKK EK EK KK KKKEK KKK KKEKKEKK EKA KEKE KKKKKKKEKKKKEKKKKKKKS 
56140 ! 

56150 FKT%=7 ‘Function number for scrolling down 
56160 GOTO 55160 ‘Call is identical with scrolling up 
56170 ! 

57000 UKKKKKKKKKEKKKKKKEKKAKKKKKEKKEKKAKKKEKEKAEKRKKKREKKEKKEKKKKRKKKAKKKEK 
57010 '* Write a character of a designated COLRR to the current x 
57020 '* Cursor position in the designated Display Page =? 
57030 !*-+~~-----~----~-----~---~---—------~+---------- +--+ - -- - = al 
97040 '* Input : CHARACTERS = the character for output eins 
57050) °° COLRR% = COLRR of the character for output = 
57060 ‘* PAGES = is the Number of the Display page = 
57070 '* Output: none ne 
57080 '* Info : the Variables ZL%, ZH% and ZE% are Dummies mA 
570930 LKKKKKKKEKKKKKKKKKKKEKKKKKKKKEKEKKKEKKKKKKKEKKKK KKK KEKKEKEKEKKKKKKKKKKKEK 
57100 ! 

597110 FKT%=9 ‘Output function numbers for character and Attribute 
57120 INR%=&H10 ‘Call BIOS-Video-Interrupt 16 (h) 
597130 Z2L%=1 ‘Output character only once (LO-Byte) 
57140 ZH%=0 ‘Output character only once (HI-Byte) 
57150 ZE%=ASC (CHARACTERS) ‘Get ASCII-Code of character to be output 
57160 CALL IA(INR%, FKT%, ZE%, PAGES, COLRR%, ZH%, ZL%, ZL%, ZLt, ZL%, ZL%, ZL%, ZL%) 
57170 RETURN ‘back to caller 
57180 ! 

58000 URKKKAKKKKAKA KKK KKK KKKAKK KK KRAKRKKRKK KR KRA KEK KEEKEKKEKAKKKAKKKKKAEKK 
58010 ‘* Output a String starting at a certain Position within a aA 
98020 '* Display page with a constant Attribute oe 
58030 !*-~-~------------------------ + ---- -- + $$ ne z= 
598040 '* Input : T$ = the String for output xs 
58050 '* COLRR&® = COLRR of the String (Attribute) ai 
598060 '* PAGE% = is the number of the Display page ms 
58070 '* DISPCOL% = Column - start of String = 
58080 '* DISPROW% = Row ~- start of String = 
58090 ** Output: none ee 
98100 ‘'* Info : the Variables ZC% and ZE% are Dummies a 
58110 CHKKKAKKKKKKKKAEKEKKEKEKKEKKKEKEKEKK KKK KEKE KKEKKKEKKKEKKKKKKKKEKKEKKEKKEE I 
58120 ' . 

58130 GOSUB 52000 ‘Set Cursor position for Output 
598140 FOR ZC%=1 TO LEN (TS) ‘process all chars or strings individually 
58150 CHARACTERS=" “ ‘output a blank first 
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58160 GOSUB 57000 

58170 ZE%=ASC (MIDS (TS, ZC%, 1) } 'Get a character from the String 
58180 FKT%=14 ‘Function number for Teletype-Output 
58190 CALL IA(INR%, FKT%, ZE%, PAGES, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%) 

58200 NEXT ‘Output next character 
58210 RETURN ‘back to caller 
58220 ! 

60000 UHRA KKK KEK KK KEK KKK KKK KEKE KKK KKK KK KEK KKK KKK KEKE KEKKKEKAKKKEKES 
60010 '* initialize the Routine for the Interrupt call 7“ 
60020 '*---~-~----~-------~----—~+--- +++ -- — -- - - + + - - - -  e- xt 
60030 '* Input : none ms 
60040 ** Output: IA is the Start address of the Interrupt-Routine i 
60050 eee eee ee eee eee ce ee eee eee ee eee ee Le See eS eS eee ee Se eS eee. ee ee 
60060 ! 

60070 IA=60000! ‘Start address of the Routine in the BASIC-Segment 
60080 DEF SEG ‘Set BASIC Segment 
60090 RESTORE 60130 

60100 FOR I = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke Routine 
60110 RETURN ‘back to caller 
60120 ! 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, O, 91, 46,136, 71, 66, 233,108,255 


The program can be divided into three parts. Lines 100 to 700 represent the 
demonstration program proper, which uses the subroutines in lines 50000 to 
58220. These subroutines call a special function of the BIOS video interrupt and 
access the routine for interrupt calls as described earlier. The program DATA 
begins on line 60000. 


See the header of each subroutine for the variables of each subroutine and what 
each variable does. 


It should be noted that all subroutines receive and return numerical values as 
integer variables. Do not forget the percentage character after a variable. In certain 
cases a real variable of the same name can be initialized, but the subroutine 
expected an integer variable and the wrong parameters will be passed to the BIOS 
function. 


and C implementations 


The individual functions and procedures of the next two programs are fully 
documented and should be self-explanatory. The two programs resemble each other 
strongly, since the procedures, functions and variables have the same names. 
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Pascal listing: VIDEOP.PAS 


{ KKH KKK KIRKE KI KEK KERR RRR KKK KEK IKK KEKE KK EK KEKE EKER EREREEKKEKEKEE | 


{* VIDEOP PASCAL *} 
{* tc ei in ess tc 'See Sp ei mw ii si is eS sm So mw be <i ier en’ et Ss es se es iw i in Gs Sw, e's So tse ad St ie Cm oe en Sew e's ai ev Sits i nh eh *} 
{* Task : makes functions available which are *} 
{* based on the BIOS-Video-Interrupt but are not *} 
{* provided by PASCAL =) 
{* a sii es lo: ou civ en ei ah ms ams weiss es es ‘nis as es Sue's cov Ss am cm cy i'n Gh im ein inh cams'cemm a cams apis Sus“ cscs ‘mm mss as ut chlo sass nce *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 07/10/87 *)} 
{* last Update 2 05/14/89 *)} 


{Fe Ree aR te eK RK KK HK KAKI KK KKKKRKKKAAKAK KKK KKK AKA KK KKK KK KKK KK 


program VIDEOP; 


Uses Crt, Dos; { Adds DOS and CRT units to Turbo } 
const NORMAL = $07; { Definition of character-attribute } 
BOLD = SOf; { in relation to a monochrome } 
INVERS = $70; { Display card } 
UNDERLINE = $01; 
BLINK = $80; 


type TextTyp = string[80]; 


var i, { Loop variable for the Main program } 
Je 
k, 
L. : integer; 
Istring : string[2]; { accepts number of Arrows } 


{ RH RHK ARKH ERK KEK KKK KKK KKK KKK KEK KEKE KK KEK KKK EK KKK KKKKKEKKEKKKKKKKKEKKE | 


{* GETVIDEOMODE: Read current Video mode and Parameters *} 
{* Input : none *} 
{* Output : The Variables listed below get the values after the *} 
{* call of the Procedure *} 


{ RRR R RRR RRR HEE RK KKK KKK KKK RE RK KK KKK KEK EKER RK KEKE EK KKKE EK KEKE KKKEKKKEKKEKE } 


procedure GetVideoMode (var VideoMode, { Number of current Video mode } 
Number, { Number of Columns per Line } 
Page : integer); { current display page } 


var Regs : Registers; { Register-Variable for call of Interrupt } 
begin 
Regs.ah := SOF; { Function number } 
intr($10, Regs); { Call BIOS-Video-Interrupt } 
VideoMode := Regs.al; { Number of Video mode } 
Number := Regs.ah; { Number of characters per line } 
Page := Regs.bh; { Number of the current display page } 
end; 


{ BEARER EKER KIRK KERR KE KEK KKK KEKE KKKEK KEK KEKE KEK KKEKEKKREKKKKKKEKE |} 


{* SETCURSORTYPE: defines the appearance of the blinking *} 
as Display cursor w} 
{* Input : see below *} 
{* Output : none =} 
{* Info : for a monochrome display card the parameters *} 
{* can be between 0 and 13, for a color display *} 
{* card between 0 and 7 =] 


{ ARKH KKH RR KEK IKK KEK KKK IKKE KK KKK KEKE KKK KKK KK KEK KARE KEKKEKKKKK KKK} 


procedure SetCursorType (Beginline, { Beginning line of the cursor } 
Endl : integer); { End line of the cursor } 
var Regs : Registers; { Register variable for the interrupt call } 
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begin 
Regs.ah := 1; { Function number } 
Regs.ch := Beginline; { Beginning and } 
Regs.cl := Endl; { End line } 
intr($10, Regs); { Call BIOS-Video-Interrupt } 


end; 


{ RAK K KIKI KR RRR KKH KKK KKK KKK RIK KKK KKK KKK KKK AKA KEK ERK KK KKK KEKEKKKEKE 1 |} 


{* SETCURSORPOS: defines the position of the cursor in the *} 
{* display page output *} 
{* Input : see below *} 
{* Output : none =} 
{* Info : The position of the blinking display cursor changes *} 
t* oniy tnrough the caii of this procedure, if tne *} 
{* indicated display page is the current display page *} 


{RRR RRR RRR KK KER KKK KKK KKK KKK RK KAR KKK KKK KKK KKK KEK KKK KRKKEKEKKEKEKKKKK KY 


procedure SetCursorPos (Page, { display whose Cursor is set } 


Column, { new Column of the Cursor } 
Line : integer); { new Line of the Cursor } 
var Regs : Registers; { Register variable for the interrupt } 
begin 
Regs.ah := 2; { Function number } 
Regs.bh := Page; { display page } 
Regs.dh := Line; { Display coordinates } 
Regs.dl := Column; 
intr($10, Regs); { Call BIOS-Video-Interrupt } 
end; 


{ RRR K HERE EK EEK K EKER KR KEK KKK EKER KEK KEK ERE KEK KKK EEK KEK EKEKEEKKEKKEE | 


{* GETCURSORPOS: senses the position of the cursor in a display *} 
{* page and its start and end line *} 
{* Input : see below *} 
{* Output : The variables listed below contain the values after *} 
{* the call of the procedure *} 
{* Info : the start and end line of the cursor is independent *} 
{* of the indicated display page *} 
{FARRAR RHR KR KKK KKK RRR KKK KKK KKK KK KEKE KKK KK RAK KKK KKK KKK KKK KKKEKKEE | 
procedure GetCursorPos (Page : integer; { the display page } 
var Column, { Column of the cursor } 

Line, { Line of the cursor } 

Beginline, { Start line of the cursor } 

} 


Endl : integer); { End line of the cursor 


var Regs : Registers; { Register variable for the interrupt } 

begin 
Regs.ah := 3; { Function number } 
Regs.bh := Page; { Display page } 
intr($10, Regs); { Call BIOS-Video-Interrupt } 
Column := Regs.dl; { Result of the Function } 
Line := Regs.dh; { read from the Register } 
Beginline := Regs.ch; { and store in proper } 
Endl := Regs.cl; { Variables } 

end; 


{ ERA ERK KKK KKK KEKE KEKKE KEK KKK KKK KEKE KEKE EK KEK KEK KKKKKKKKKKEKEKEKE | 


{* SETDISPLAYPAGE: set the display page =} 
{* for output on the monitor *} 
{* Input : see below *} 
{* Output > none *} 


{ BARAK H RHEE KER KKEK KKK RK KKK KKK KKK KEKE KKK KHER KKK KKK ERE KKK KKEKKKKEKEKKKKKEKE | 


procedure SetDisplayPage (Page : integer); { the new display page } 


var Regs : Registers; { Register variable for the interrupt } 
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begin 
Regs.ah := 5; { Function number and display page } 
Regs.al := Page; { Screen page } 
intr($10, Regs); { Call BIOS-Video-Interrupt } 


end; 


{ERR KKK KERR EK KEKE KEK KEK KEK KKK KEE KKK EKKE KEKE KKK EKKE KEK EREKEKKEKKKKK | 


{* SCROLLUP: scrolls a display area by one or more *} 
{* lines up or erases it *} 
{* Input : see below *} 
{* Output : none *} 
{* Info : If Number 0 is passed, the display area * } 
{* is filled with blanks x) 


{ HR RAH RR RK KR KKH KKK RRR KKK KKK KKK IKK RIKER RK KKK KIKEK HARK AK KKK KAK KAY 


procedure ScrollUp (Number, { Number of lines to be scrolled } 
COLOR, { Attribute for the blank lines created } 
ColumnuL, { Column in the upper left hand corner } 
LineuL, { line in the upper left corner } 
ColumnLR, { Column in the lower right corner } 
LineLR : integer);{ line in the lower right corner } 
var Regs : Registers; { Register variable for calling Interrupt } 
begin 
Regs.ah := 6; { Function number and number } 
Regs.al := Number; 
Regs.bh := COLOR; { Color of empty line(s) } 
Regs.ch := LineUL; { Upper left } 
Regs.cl := ColumnUuL; { coordinates } 
Regs.dh := LineLR; { Lower right } 
Regs.dl := ColumnLR; { coordinates } 
Intr($10, Regs); { Call BIOS-Video-Interrupt } 
end; 


{ BAAR HAKKAR KKK KERR K KARR AKKK KK KEKE K KK KKK KEKE EKKKKKEKREEKKEKE EK | 


{* SCROLLDOWN: Scrolls a display area by one or more *} 


{* lines down or erases it x} 
{* Input : see below a 
{* Output : none *} 
{* Info : If Number O is passed, the display area x} 


{* is filled with blanks *} 


{ HA HAKAEKK KKK KKK KEKE ERK EREK EK KEK KKK KEK KEK KEK KK KEKE KEE KEKE KEKEKEREKKEKREKE | 


procedure ScrollDown (Number, { Number of lines to be scrolled 


} 
COLOR, { Attribute for the blank line(s) created } 
ColumnuUL, { Column in the upper left corner } 
LineUL, { line in the upper left corner } 
ColumnLR, { Column in the lower right corner } 
LineLR : integer); { Line in lower right corner } 
var Regs : Registers; { Register-Variable for call of Interrupt } 
begin 
Regs.ah := 7; { Function number and number } 
Regs.al := Number; 
Regs.bh := COLOR; { Color of blank line(s) } 
Regs.ch := LineUL; { upper left } 
Regs.cl := ColumnuL; { coordinates } 
Regs.dh := LineLR; { Lower right } 
Regs.dl := ColimnLR; { coordinates } 
Intr($10, Regs); { Call BIOS-Video-Interrupt } 
end; 


{ RRR RRA KKK EK HAH KE RK EKER KKK KKK KEE KERR EKER KKK KK KEK KEK ERK KKK EKKEKRKKKEKKEKKEKER | 


{* GETCHAR: Read a character including Attribute from an indicated *} 
{* position in a display page *} 
{* Input : see below *} 
{* Output : see below *} 


{ BARRA KEK KAKI ERK EK KEK KKK KKK KKK KKK KKK KKK KEKE KKK KEK KKK KKK KKK KK | 


246 


Abacus 


7.4 BIOS Screen Output Functions 


procedure GetChar (Page, 
Column, 


{ display page accessed 
{ Display Column 


{ Display line 
{ the character 
{ its Attribute 


Line : integer; 
var Character : char; 
var COLOR : integer); 


var Regs : Registers; { Register-Variable for the Interrupt 


} 

CurColumn, { current display Column } 

CurLine, { current display line } 

CurPage, { current display page } 

Dummy : integer; { stores Variables which are not needed } 
hegin 


Get VideoMode (Dummy, Dummy, CurPage) ; { sense current display page 
GetCursorPos (CurPage, CurColumn, CurLine, { Get cursor position 

Dummy, Dummy) ; { in the current display page 
SetCursorPos (Page, Column, Line); { cursor on the position indicated 


yet et es tee 


{ Get Function number for char. and Attribute 

{ display page 

{ Invoke DOS registers 

Character := chr(Regs.al); { ASCII-Code of character 

COLOR := Regs.ah; ; { Attribute of the character 

SetCursorPos (CurPage, CurColumn, CurLine);{ Set cursor old position 
end; 


Regs.ah := 8; 
Regs.bh := Page; 
Intr($10, Regs) ; 


v 


{ RAH RRR KKK IKK KK KKK KKK IKK KK KKK KKK KKK IKK KKK RIKER KEKE KK KEKE KEK KKEKKEKREKEKEK | 


{* WRITECHAR: Writes a character with indicated color to the *) 
{* current cursor position in the display page *} 
{* indicated 4 
{* Input : see below *} 
{* Output : none *} 
{* Info : during the Output of characters, the control codes *} 
{* such as Carriage-Return are treated as ASCII codes *} 


{ERR RKKREK KKK KKK KKK KEK KKK ERE RK KEKE KEKKKEREK KER KKK KK } 


procedure WriteChar (Page : integer; 
Character : char; 
COLOR : integer); 


{ Display page for writing } 
{ ASCII-Code of the character } 
{ its Attribute } 


var Regs : Registers; { Register variable for the interrupt 
begin 
Regs.ah := 9; 
Regs.al := ord(Character); { Function number and character code 
Regs.bh := Page; { Display page 
Regs.bl := COLOR; { Display color 
Regs.cx := 1; { output character only once 
Intr($10, Regs); { Call BIOS-Video-Interrupt 
end; 


{BRA KK KKK KKKEKKEEKK KKK KEK HEKK KKK KEK KKK IKK KKKKKKKKKKKKEKKEKKKEKEKKKEKEKKEKK | 


{* WRITETEXT: Writes a String starting at an indicated position in *} 


{* a display page. *} 
{* Input : see below *} 
{* Output : none *} 
{* Info : During output of characters the control characters *} 
i> such as Carriage-Return are treated as such. =} 
{* If writing continues beyond the End of the display, *} 
{* will be scrolled up one line ° *} 


{ RARER RHR REK KKK KKK KEK KKK KKK KKK KKK KEK KEKKKKKEKKEKKEKKKKEKKEK 


procedure WriteText (Page, { Display page for output 


} 

Column, { Column, from which output starts } 

Line, { Line, from which output starts } 

COLOR : integer; { Color for all characters } 

Text : TextTyp); { Text for output } 

var Regs : Registers; { Register variable for call of Interrupt } 


} 


at ete ee ee 
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Counter : integer; { Loop Counter } 
begin 
SetCursorPos (Page, Column, Line); { Set cursor } 
for Counter := 1 to length(Text) do { process characters } 
begin { in sequence } 
WriteChar (Page, ‘' ', COLOR); { Color at the current position } 
Regs.ah := 14; 
Regs.al := ord(Text [Counter]); { Function number and character } 
Regs.bh := Page; { Display page } 
Intr ($10, Regs); { Call BIOS-Video-Interrupt } 
end; 
end; 
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{ FREAK KEKE KKK KKK KEK RK KEK KKK KER KKK KEK ERK KKK EKER KEKE KKEKKKEKKKEKKEKE | 


{(e MAIN PROGRAM xe} 
[RRR IIR I RII TOTO ICICI CITT I IITA AKITA TAK IK KRIS 


} 


+ 
ae 
} 
} 


} 


begin 
clrscr; { Erase display 
for i := 1 to 24 do { Perform line 1 to 24 
for j := 0 to 79 do { do all Columns 
begin 
SetCursorPos(0, j, i}; { position cursor 
WriteChar(0, chr(i*80+j and 255), NORMAL); { Write a character 
end; 
ScrollDown(0, NORMAL, 5, 8, 19, 22); { Erase Window 1 
WriteText (0, 5, 8, INVERS, ' Window 1 “) 
ScrollDown(0, NORMAL, 60, 2, 74, 16); { Erase Window 2 
WriteText (0, 60, 2, INVERS, ' Window 2 '); 
WriteText (0, 24, 12, INVERS or BLINK, ‘ >>> PC SYSTEM PROGRAMMING <<< '); 
WriteText (0, 0, O, INVERS, ' Still have to draw 
‘ arrows on the screen 
for i := 49 downto 0 do { draw a total of 50 Arrows 
begin 
str(i:2, IString); { convert i in ASCII-String 
WriteText (0, 37, 0, INVERS, IString); 
j :=1; { every Arrow consists of 16 lines 
while j <= 15 do 
begin 
k := 0; 
while k < j do { create a line of the Arrow 
begin 
SetCursorPos(0, 12-(} shr 1)+k, 9); { Arrow Window 1 
WriteChar(0, '*', BOLD); 
SetCursorPos(0, 67-(} shr 1)+k, 16); { Arrow Window 2 


WriteChar(0, '*', BOLD); 
k := succ(k); 


end; 
ScrollDown(1, NORMAL, 5, 9, 19, 22); { scroll Window 1 
ScrollUp(1, NORMAL, 60, 3, 74, 16); { scroll Window 2 
for 1 := 0 to 8000 do { Wait Loop 
J := 342; 
end; 
end; 
clyscr} { Erase display 
end. 
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C listing: VIDEOC.C 


[RRR IKI KIKI II KIKI IK KIRK KIKI IKK IKI IKK KKK KKK KIER AKIKK KER AAAI / 


/* VIDEOC */ 
/* eset cp ec cs mee ii ems“ cc soe css ee as Sms a scabs Sc ssa es cas mace mb csc ns a us me hp ‘co ma nn Ui as ei "Ss es spp cm SUG Sse ‘ei es lus‘ an i el x/ 
f* Task : makes functions available which are not x7, 
[* available from the Library of MICROSOFT and */ 
/* the TURBO C-Compilers of J 
/* Ce ass al cc es es ss ats sinc sc a es ahs cs sw wes es ed ga nc mda es chs sme cs sh ee cep cc ss ca “i Cs Sc “ci sane cus is. em ce x/ 
/* Author : MICHAEL TISCHER df 
{* developed on : 08/13/87 x7. 
/* last Update : 05/14/89 */ 
/* Fen ny a ac a Ses es ms ss a nn Ms ek ci aa a mcs mw Se ek ss Ss cs Ss Si me sees ee Se end ee ew ce */ 
{= (MICROSOFT Cj */ 
/* Creation : MSC VIDEOC; */ 
f* LINK VIDEOC; a! f 
/* Call : VIDEOC */ 
/* Tui iu ins th Sok ees Sieh’ ci camels ls us el is en i es tm es “ses an ec ‘Sm eis asset ca emai, a ui ‘kama ee ae ss enh ih i‘ “in ln Sms oi ss x/ 
{* {BORLAND TURBO C) */ 
Ys Creation : through the RUN command on the menu bar ey 


[RIKKI KK IKK IKK KKK KIRK HRA KKK KKK KKK KKK I IKK KKK KKK KK IAA KKK KKK KIER KKK KKKK EK / 


#include <dos.h> /* include Header-Files */ 
#include <io.h> 


#define NORMAL 0x07 /* Definition of the character Attribute */ 
#define BOLD Ox0F /* in relation to a monochrome */ 
#define INVERS 0x70 /* Display card */ 
#define UNDERLINE 0x01 
#define BLINK 0x80 


[BRK IKK KKK KKK KKK IKK KKK KKK KKK KKK IKK IKK KKK KKK IKK RK KKK KKK KKK KK / 


/* GETVIDEOMODE: Read current Video mode and Parameters */ 
/* Input : none w7] 
/* Output : see below */ 


[RRR RK KK KKK KIKI KKK KKK KKK KEK IK KKK KEK KK AK KKH RK KEKE KKK KEKE KEK KEK KKK KK / 


void GetVideoMode (VideoMode, Number, Page) 


int *VideoMode; /* the Number of the Video mode */ 
int *Number; /* Number of Columns per line */ 
int *Page; /* Number of current display page */ 
{ 
union REGS Register; /* Register variable for Interrupt-Call */ 
Register.h.ah = 15; /* Function number */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 
*VideoMode = Register.h.al; /* Number of Video mode */ 
*Number = Register.h.ah; /* Number of Characters per line */ 
*Page = Register.h.bh; /* Number of current display page */ 


} 


[RRR KKKIK KKK K KKK RAK KKK KHAKI KKK KKK KKKAK KAKA KKK KKK KKK KKK KEKKKKKKKKK / 


/* SETCURSORTYPE: defines the appearance of the blinking display uid 
[* cursor */ 
/* Input : see below tA 
/* Output : none */ 
/* Info : for a monochrome display card the parameters */ 
faa! can be between 0 and 13. For a color a A 
7* display card between 0 and 7 eS: 


[RRR RIK KKK IKI IK KKK IKK AIK IK KK KIKI KK KKK KK IKK KKK KK KKK KER KKK KK IK KK / 


void SetCursorType (Beginline, Endl) 


int Beginline; /* Beginning line of the cursor */ 
int Endl; /* End line of the cursor */ 
{ 

union REGS Register; /* Register variable for Interrupt-Call */ 
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Register.h.ah = 1; /* Function number */ 
Register.h.ch = Beginline; /* Beginning line of cursor */ 
Register.h.cl = Endl; /* End line of cursor */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 


} 


[BIH IK III KIKI KIKI KKK KIRK KK IKK KEKE KKK KEKEKKEKEKKAKIKREKKKKKAKKKKAKK KK / 


/* SETCURSORPOS: defines the position of the cursor in the indicated */ 


i display page a A 
/* Input : see below a7 
/* Output : none */ 
/* Info : The position of the blinking display cursor changes */ 
/* only. if the call of this function refers to */ 
/® current display page */ 


[ERK KK KKK KKK KEKE KKK ERIK RE KKK EK KKK KKK KKK KK ERK KEKK IKKE EK ERK KEKE KKK EK / 


void SetCursorPos (Page, Column, Line) 


int Page; /* Display page where the cursor will be set */ 
int Column; /* new cursor Column */ 
int Line; /* new cursor line */ 
{ 

union REGS Register; /* Register variable for Interrupt-Call */ 
Register.h.ah = 2; /* Function number */ 
Register.h.bh = Page; /* Display page */ 
Register.h.dh = Line; /* Display line */ 
Register.h.dl = Column; /* Display Column */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 


} 


[BRK KKKIK KKK KKK KKK KKK KEIR EK IK KK EK KAKI KIRK AKER KIEK KKK K KEKE KKK KRKEKAIK KKK / 


/* GETCURSORPOS: Get the position of the cursor in a certain od 
/* display page and its start and end line ay 
/* Input : none a 
/* Output : see below it 4 


[RE KRKKR KEK KKK KEK KKK KKK RK KIKI K KKK RE KIAK KKK KEKE KIKKIK IKKE ERK AKER / 


void GetCursorPos (Page, Column, Line, Beginline, Endl) 


int Page; /* Number of display page */ 
int *Column; /* Column, where the cursor is located */ 
int *Line; /* Line, where the cursor is located */ 
int *Beginline; /* Start line of the cursor */ 
int *Endl; /* End line .of the cursor */ 
{ 

union REGS Register; /* Register variable for Interrupt-Call */ 
Register.h.ah = 3; /* Function number */ 
Register.h.bh = Page; /* Display page */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 
*Column = Register.h.dl; /* Read result of the Function */ 
*Line = Register.h.dh; /* from the Registers */ 
*Beginline = Register.h.ch; /* and assign to proper */ 
*Endl = Register.h.cl; /* Variables */ 


} 


[RRR RRR RRR RII IKI IK IK IKK KKK IKK IK IK IKK KKK IKK IKK IKK KKK KEKE KIK KEKE / 
/* SETDISPLAYPAGE: sets the display Page which is to be represented */ 


[* on the display *f 
/* Input : see below */ 
/* Output : none */ 


[RRR RRR IKK IKK IK II KIKI KK IKK KKK KKK KKK KKK KKK AIK IEKKAKKIKKKK KKK KKK / 


void SetDisplayPage (Page) 
int Page; /* Number of the new current display page */ 


{ 
union REGS Register; /* Register variable for Interrupt call */ 
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Register.h.ah = 5; /* Function number */ 
Register.h.al Page; /* Display page */ 
int86 (0x10, &Register, &Register); /* Call Interrupt 10(h) */ 
} 


[RRR KKK KKK IKE KKK KEK KKK KKK IKKE KKK EKA KKKKKE KKK KKK KK KKK KKK KK KK 


/* SCROLLUP: Scrolls a display area up one or several */ 
/* lines or erases it */. 
/* Tnput : see below */ 
/* Output +: none */ 
/* Info : If 0 is passed as number, the display */ 
/* area is filled with blanks */ 


[III III IK III ITT TTT TOI TTT TT TTI TTI TTI TIT IIIA IIHT IAA AA KAA KKK IKK / 


void ScrollUp(Number, Color, ColumnUL, LineUL, ColumnLR, LineLR) 
int Number; /* Number of lines to be scrolled */ 
int Color; /* Color or Attribute for the blank lines */ 


int ColumnUL; /* Column in upper left 
int LineUL; /* Line in upper left 
int ColumnLR; /* Column in lower right 


corner 
corner 
corner 


of the display area */ 
of the display area */ 
of the display area */ 


int LineLR; /* Line in lower right corner of the display area */ 


{ 
union REGS Register; /* Register variable for Interrupt call */ 
Register.h.ah = 6; 
Register.h.al = Number; 
Register.h.bh = Color; 
Register.h.ch = LineUL; 
Register.h.cl = ColumnUL; 
Register.h.dh = LineLR; 
Register.h.dl = ColumnLR; 
int86(0x10, &Register, &Register); 
} 


/* Function number */ 

/* Number of lines */ 

/* Color of blank line(s) */ 

/* Set Coordinates of the */ 

/* display Window to be scrolled */ 
/* or erased */ 


/* Call Interrupt 10(h) */ 


[RRR EK KEKE KKK KEK KEK KAR KEK KKK KKK KKK EKER KIRK KKK IKKE K KKK ERK KKK KKK KE KKK KKK / 


/* SCROLLDOWN: Scroll a display area by one or more */ 
[5 lines down or erase it ey. 
/* Input : see below df 
/* Output : none */ 
f*® Into : If 0 is passed as number, the display */ 
7% area is filled with blanks * f 


[RRR KIKI KKK KK KKK KIKI IK IKK KIKI RIK AK KEK KEIR KEKE KKK KKK KEKE KKK KEKKEKKKK / 


void ScrollDown (Number, Color, ColumnUL, LineUL, ColumnLR, LineLR) 

int Number; /* Number of lines to be scrolled */ 
int Color; /* Color or Attribute for the blank lines */ 
int ColumnUL; /* Column in upper left corner of the display area */ 
int LineUL; /* Line in upper left corner of the display area */ 
int ColumnLR; /* Column in lower right corner of the display area */ 
int LineLR; /* Line in lower right corner of the display area */ 


{ 
union REGS Register; /* Register variable for Interrupt call */ 
Register.h.ah = 7; 
Register.h.al = Number; 
Register.h.bh = Color; 
Register.h.ch = LineUL; 
Register.h.cl = ColumnuL; 
Register.h.dh = LineLR; 
Register.h.dl = ColumnLR; 
int86(0x10, &Register, &Register); 
} 


/* Function number */ 

/* Number of lines */ 

/* Color of blank line(s) */ 
/* Set Coordinates for the */ 
/* display window to be */ 

/* scrolled or erased */ 


/* Call Interrupt 10(h) */ 


[RRR RK IKK KK KEK KIRK IK KKK KKK KIRK IK KIKI IKK KKK HK KKK KEK KKK KKK KKKKEKKKKK / 


/* GETCHAR: Read from a designated display position xy 
f* a character and its Attribute-Byte a 4 
/* Input :; see below */ 
/* Output : see below a] 


[RRR KKK KKK KEK KEK KER KEKE KEKE KEKE EK KKK KEK KKK KEK KEKKKEK KEKE KKK EKEKEKKKKKKKKE / 
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void GetChar (Page, Column, Line, Character, Color) 
int Page; 


int Column; 


int Line; 
char *Character; /* the character at this position */ 


int *Color; 


{ 


/* Display page from which the character is to be read */ 
/* Display column of the character */ 
/* Display line of the character */ 


/* its Attribute-Byte (Color) */ 


union REGS Register; /* Register variable for Interrupt call */ 


int Dummy; 


int CurPage; 
int CurLine; 


/* for Variables which are not required */ 
/* the current display page */ 
/* the current display line */ 


int CurColumn; /* the current display Column */ 
Get VideoMode (&Dummy, &Dummy, &CurPage); /* Get current display page */ 
GetCursorPos (&CurPage, &CurColumn, &CurLine, /* Get current cursor */ 

&Dummy, &Dummy); /* position */ 
SetCursorPos (Page, Column, Line); /* Set cursor */ 
Register.h.ah = 8; /* Function number */ 
Register.h.bh = Page; /* display page */ 
int86 (0x10, &Register, &Register); /* Call Interrupt 10(h) */ 
*Character = Register.h.al; /* Read results from the Registers */ 
*Color = Register.h.ah; /* and assign */ 
SetCursorPos (CurPage, CurColumn, CurLine);/* cursor to old position */ 


} 


[BRK KEKE KKK KKK KKK KKK KKK KKK KEKE KKK KEKE KEK EKER EEK KKK KEKKKEKKEKE / 


/* WRITECHAR: writes a character with an Attribute */ 
/* at the current cursor position in the page indicated iad & 
/* Input : see below */ 
/* Output : none i 


[RR KRK RIK KIKI IKK KKK AK KEK IKK KKK KK KKH KKK KKK KEK KK KEKKEKKKKKKKAKK KEKE / 


void WriteChar (Page, Character, Color) 


int Page; /* The character appears in this display page */ 
char Character; /* the character to be output */ 
int Color; /* its Attribute or Color */ 
{ 

union REGS Register; /* Register variable for Interrupt call */ 
Register.h.ah = 9; /* Function number */ 
Register.h.al = Character; /* the character to be output */ 
Register.h.bh = Page; /* display page */ 
Register.h.bl = Color; /* Color of character to be output */ 
‘Register.x.cx = 1; /* output character only once */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 


} 


[RK RIK KIER IKK RIKKI KKK KKK IIR KI KK IKK KERIKERI KKK IKK EEE KK KEKE KKK KKK KE / 


/* WRITETEXT: Writes a character string with constant color xf 
is starting at a designated position within a display page*/ 
/* Input : see below */ 
/* Output : none */ 
/* Info : Text is a pointer to a character vector which contains */ 
/* the text to be output and is terminated a A 
[* with a '\O' character ad 


[ERK RRR KKK IKK IKK IKK IKK KKK KKK KK KKK KEK KKK IKKE KKK KKK KKK KEKKEKK KKK KK KKK / 


void WriteText (Page, Column, Line, Color, Text) 


int Page; /* the Text is output in this display page */ 
int Column; /* display Column for Output */ 
int Line; /* display line for Output */ 
int Color; /* Color/Attribute of the Text */ 
char *Text; /* Text for output */ 
{ 

union REGS Register; /* Register variable for Interrupt call */ 
SetCursorPos (Page, Column, Line); /* Set cursor */ 
while (*Text) /* Output Text up to ‘'\0' character */ 


{ 
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WriteChar (Page, ' ', Color); /* Color for characters */ 
Register.h.ah = 14; /* Function number */ 
Register.h.bh = Page; /* display page */ 
Register.h.al = *Text++; /* the character for output */ 
int86(0x10, &Register, «&Register); /* Call Interrupt */ 


} 
} 


[RRA IKKE KIKI KKK KKK IKK IKK KK KIKI KKK KIRKE KK IKKE KEK KEK KK KIKI / 


/* CLEARSCREEN: erase the 80*25 character Text display and set */ 
/* cursor into the upper left display corner «/ 
/* Input : none */ 
/* Output : none at 


void ClearScreen () 


{ 


int CurPage; /* current display page */ 
int Dummy; /* Dummy variable */ 
ScrollUp(0, NORMAL, 0, 0, 79, 24); /* clear screen */ 
Get VideoMode (Dummy, &Dummy, &CurPage); /* Get current display page */ 
SetCursorPos (CurPage, 0, 0); /* Set cursor */ 


} 


[RRR KKK KK KIKI KI KKK KKK IK KIKI KIRKE KEK KHAK KIKI KEK KEKAKRKKKKKREKKKKKKKKE / 


Zee MAIN PROGRAM ial 


[RRR KKK EEK KKK KKK KK AKER KKK KAKA KKEKKKRKKK KAA AKA AKK KKK KKK KK KKK IKK / 


void main() 


{ 


int. iy Jy keaa¢ /* Loop variables */ 
char Arrows[3]; /* accepts number of Arrows as ASCII-String */ 
ClearScreen ({);7 /* Clear Screen */ 
for (i = 1; i < 25; i++) /* process all lines */ 
for (j = 0; j < 80; j++) /* process all Columns */ 
{ 
SetCursorPos (0, j, i)? /* position cursor */ 
WriteChar(0, 1*80+3&255, NORMAL); /* write characters */ 
} 
ScrollDown(0, NORMAL, 5, 8, 19, 22); /* erase Window 1 */ 
WriteText (0, 5, 8, INVERS, " Window 1 ne) Br 
ScrollDown(0, NORMAL, 60, 2, 74, 16); /* erase Window 2 */ 
WriteText (0, 60, 2, INVERS, " Window 2 bas 
WriteText (0, 24, 12, INVERS | BLINK, " >>> PC SYSTEM PROGRAMMING <<< "); 
WriteText (0, 0, 0, INVERS, “ There are ") 3 
WriteText (0, 40, 0, INVERS, "arrows left to draw "); 
for (i = 49; i >= 0; i--) /* draw 50 Arrows */ 


{ 
sprintf (Arrows, "%2d", i); /* Convert number of Arrows to ASCII */ 


WriteText (0, 37, 0, INVERS, Arrows); /* and output */ 
for (j = 1; 3 < 167 jt= 2) /* every Arrow consists of 16 lines */ 
{ 
for (k = 0; k < 4; k++) /* create a line of the Arrow */ 
{ 
SetCursorPos (0, 12-(j>>1)+k, 9); /* Arrow Window 1 */ 
WriteChar(0, '*', BOLD); 
SetCursorPos (0, 67-(j>>1)+k, 16); /* Arrow Window 2 */ 


WriteChar(0, '*', BOLD); 


} 
ScrollDown(1, NORMAL, 5, 9, 19, 22); /* Scroll Window 1 down */ 


ScrollUp(1, NORMAL, 60, 3, 74, 16); /* Scroll Window 2 up */ 
for (1 = 0; 1 < 4000 ; 1++) /* Wait Loop */ 

} 

} 
ClearScreen({); /* Clear Screen */ 


} 
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7.4.1 The EGA and VGA BIOS 


The BIOS functions for screen output have been part of ROM-BIOS since the early 
days of the PC. Although they have proven themselves in thousands of 
applications, they don't work with the newer types of graphic cards. EGA and 
VGA cards are becoming more and more common in the PC market. 
Incompatibilities arise between hardware and software, because these cards have 
little in common with the CGA and MDA cards for which the original BIOS 
functions were intended. 


To make EGA and VGA cards compatible with programs that use BIOS functions 
to do their screen output, the BIOS functions must first be adapted to the new 
hardware standards. The first option would be to replace the ROM-BIOS on the PC 
motherboard with new ROMs. This solution can create other problems, because no 
set standard currently exists for EGA or VGA. Unlike the CGA and MDA cards, 
where the IBM standard took over simply because there were no other alternatives, 
EGA and VGA manufacturers have yet to define a universal standard. Such a 
standard would have to apply to hardware, options and capabilities as offered by 
each manufacturer. 


EGA/VGA ROM-BIOS 
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Since trying to adapt the ROM-BIOS included with the computer to every graphic 
card on the market is impractical, the manufacturers of these systems use the 
Opposite approach. They package an independent ROM-BIOS with their video 
cards. There is a small ROM on the video card itself which contains the necessary 
screen Output functions. When the system is booted, the BIOS detects this ROM 
expansion and allows it to redirect the BIOS video interrupt 16H to its own 
routines, replacing the old functions. 


By using these routines, all of the programs which use BIOS functions for output _ 
can be executed without problems, but the enhanced capabilities of these video 
cards are not used. Since the ROM-BIOS on the motherboard is intended to work 
only with CGA and MDA cards, it supports only the capabilities of these cards. 
So the graphic card manufacturers extend the BIOS in these video cards by 
including new functions or upgrading old functions, so that the enhanced video 
capabilities can be used. 


This section is dedicated to these functions. No real standard exists for these BIOS 
extensions, as mentioned previously. We could use this section to describe the 
video functions of the more important EGA and VGA cards (many different cards), 
but even with this information you still wouldn't be able to write programs which 
would be compatible with all of the video cards on the market. Writing a program 
for a specific video card makes sense only when you want the program to run with 
that card only. 


Abacus 7.4 BIOS Screen Output Functions 


EGA/VGA video modes 


Instead, let's look at the lowest common denominator, the video modes and 
functions supported by virtually all EGA/VGA cards. If you stick to this "low- 
level" standard, you can be fairly sure that your programs will run properly with 
all EGA/VGA cards. The basis of this standard is the set of video modes supported 
by the original EGA card, introduced by IBM in 1985, or the original VGA card, 
introduced by IBM in 1987. All of the manufacturers of compatible cards have 
included similar functions in their own cards, and added their own features. 


All EGA and VGA cards have flexibility in common, which allows them to 
emulate other video cards, as well as perform other tasks. The type of emulation 
depends on the monitor connected, since unlike other cards, EGA/VGA cards can 
by used with different types of monitors. 


Monitors and EGA/VGA 


If you connect a monochrome monitor to an EGA or a VGA card, it assumes the 
features of an MDA or Hercules graphic card. If you connect a color monitor to an 
EGA or a VGA, it emulates a normal CGA card. However, EGA/VGA cards run 
best when connected to a multisync monitor, which allows color displays at higher 
resolutions than Hercules or CGA. The standard resolutions (640x350 for EGA, 
640x480 for VGA) can be displayed on a multisync monitor with no problem. 
However, multisync monitors also support the higher resolutions available on 
many EGA and VGA cards. Resolutions of 800x600 pixels and 1024x768 pixels, 
are common. These higher resolutions can be used only if the EGA/VGA card has 
enough RAM, since the extended graphics mode requires additional video RAM to 
handle the higher resolutions. The programmer doesn't have to worry much about 
this, because almost all EGA cards come with 256K RAM standard. Very few 
EGA cards come with a mere 64K and must be expanded to 256K. Most VGA 
cards come equipped with 256K of video RAM, as well as a special VGA BIOS. 
This special BIOS may require special drivers to operate in conjunction with 
graphical user interfaces such as GEM® or Microsoft Windows®. 


In addition, to support the new graphic modes with higher resolutions, EGA cards 
offer a palette of 16 colors chosen from the 64 available colors. In text mode it is 
also possible to set the heights of individual characters, so that up to 43 lines can 
be displayed on the screen at once, instead of the normal 25 lines. 


VGA features 


The VGA card is even more powerful. In text mode, the VGA card can display 25 
lines, 43 lines and even 50 lines of text. In addition, the VGA has even more 
colors available (262,144 colors, as opposed to the EGA's 64-color spectrum). Of 
course, these colors are only effective when displayed on a monitor that has a high 
enough resolution. 
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The rest of this section shows how these extended features can be used and how the 
original BIOS functions have changed. 


As with the normal BIOS, all of the video modes in the EGA/VGA BIOS are set 
with the help of function 00H of the BIOS video interrupt. This function has not 
been changed since the old BIOS, but it has been extended. The number of the 
video mode to be set is passed in the AL register. The following codes are allowed: 


EGA/VGA Card Video Modes 


[Code | Mode Mono conor | EGA/vCA | 
[OOH 4. 40x25 characters, 16 colors| | @ | @ | 
O1H_ __| 40x25 characters, 16 colors} | @ | @ 
02H [80x25 characters, 16 colors} = | @ | @ 
jo3H___| 80x25 characters, 16 colors} | ™@ | @ 
Jo4H_ | 320x200 graphic pixels, 4 colors] | @ | @ | 
[O5H___| 320x200 graphic pixels, 4 colors| =| | @ 
[06H __| 640x200 graphic pixels, 2 colors} | @ [| @ | 
07H [80x25 characters, monochrome] Mf 
[ODH__| 320x200 graphic pixels, 16 colors| | | 
[ORH _ | 640x200 graphic pixels, 16 colors| | —=ss| 
[OFH __| 640x350 graphic pixels, monochrome] M | | 
10H ___| 640x350 graphic pixels,16 colors**| [| | 
11H | 640x480 graphic pixels, 2 colors| | | 
12H | 640x480 graphic pixels, 16 colors| | | 
13H [230x200 graphic pixels, 256 colors} | | 


i. VGA only 
lis’ EGA cards with 64K of added RAM can only displa 


4 colors 


EGA and VGA cards can suppress clearing the video RAM when switching to a 
new video mode. If you want to to do this, bit 7 of the AL register must be set in 
addition to video mode number when the function is called. 


The codes listed above are also valid for the function OFH, which is used to 
determine the current video mode. 


Nothing much has changed in functions 01H to OEH. Slight changes have been 
made to functions 01H and 03H, which define and read the design of the cursor. We 
will discuss these changes later. You can also get exact descriptions of these 
functions from the appendices, where all of the functions of the EGA/VGA BIOS 
are described. 


Extended functions 
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After function OFH, which also appeared in the old ROM-BIOS, we have three 
new EGA/VGA functions numbered 10H, 11H, and 12H. These new functions are 
- dedicated to a specific task and have a number of sub-functions. 


Abacus 7.4 BIOS Screen Output Functions 


Function 10H 


Function 10H comprises all of the sub-functions for using the color capabilities of 
the EGA/VGA cards. Before we describe these functions, we should first look at 
the way in which the EGA and VGA cards create colors. 


Unlike the MDA and CGA cards, the two nibbles of the attribute byte of a 
character in text mode do not directly specify the color or attributes of the character 
in the EGA. They comprise an index to one of the 16 palette registers of the EGA 
card, which then contains the actual color. This makes it possible to set the desired 
colors individually, and allows color changes simply by changing the contents of 
the palette registers. The interpretation of the palette register contents, and the 
number of displayable colors, depend on the type of monitor used. The EGA card 
itself can generate 64 colors, but these can be displayed only on EGA or multisync 
monitors, since these monitors have the six color lines required (2° = 64). There 
are two lines available for each fundamental color (red, green, and blue), where the 
two lines control the intensity level of the color. These six lines correspond 
directly to the lower six bits of a palette register, as the following figure shows. 


Red (less intense) 


EGA palette registers when connected to EGA or multisync monitor 


This color scheme is not available when a normal color monitor is connected. It 
has only four lines for the color representation, three of which are assigned the 
fundamental colors red, green, and blue. The fourth line simply allows the 
resulting color to be displayed at higher intensity. These limited possibilities affect 
the structure of the palette register, which clearly differs from the six-bit structure 
used when an EGA or multisync monitor is connected. A total of only 16 colors 
can be displayed in this mode. 
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EGA palette registers when connected to a color monitor 


The bits of a palette register take on a completely different meaning when the card 
is connected to a monochrome monitor. In this case the monitor cannot display 
different colors, and can only display bright, inverse, and underlined characters. 
When connected to such a monitor, the meanings of the individual bits correspond 
to those of the attribute byte of an MDA card, which we examined earlier in this 
chapter. 


DAC color table 
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The VGA card also uses the most significant and least significant nibbles of the 
attribute byte as an index, pointing to one of 16 palette registers. Unlike the EGA 
card, which only contains the color code, this byte contains a value between 0 and 
255. This number acts as a reference to the DAC (digital analog converter) color 
table. This table allows the VGA card to convert a digitally notated color code into 
an analog video signal. The DAC color table sees each color code as three six-bit 
values, with each value representing the degree of red, green and blue intensity in 
the color. 


As the following figure shows, the color code layout in some registers plays a role 
which also involves the BIOS. Bit 7 of each value controls the grouping of the 
different registers in the DAC color table, thus controlling the mode control 
register of the video controller. If this bit contains a 0, the index in the DAC color 
table bases its palette register on the contents of bits 0 to 5, and the color select 
register on bits 2 and 3. The consequence is that the DAC color table is divided 
into four groups of 64 consecutive registers. The value in the palette register 
represents the index in this group, whereby the active group itself selects the color 
based on the contents of bits 2 and 3 of the color select register. | 


When bit 7 of the mode control register contains a 1, the DAC color table divides 
into 16 groups of 16 consecutive registers. The index of this table is based on bits 
0-3 of the corresponding palette register, and bits 0-3 of the color select register. 
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These registers select the active color group from within the DAC color table, and 
the contents of the palette registers represent the index of this group. 


You can use this form of coding for creating fast and easy color changes when 
characters on the screen must be changed rapidly. This involves storing different 
groups in the DAC color table which specify brighter or darker colors, and quickly 
incrementing the active color grouping through the color select register. 


ote etey 


4 groups of 16 groups of 
64 entries 16 entries 


Mode-Control-Register Mode-Control-Register 


Color code layout of the VGA card 


To perfectly emulate a CGA or an MDA card, the EGA/VGA BIOS sets the 
individual palette registers (or in the case of the VGA card, the DAC color 
registers) to the same color scheme used by a CGA or an MDA card when the 
corresponding mode is initialized. In the case of CGA emulation (EGA/VGA card 
and a CGA monitor), this means that palette register 0 contains the value 0, 
palette register 1 the value 1, etc. At the same time, the color select register of the 
VGA card must be set to the first of 16 palettes whose color codes correspond to 
those of a CGA card. This also applies to CGA modes 4 and 5 (320x200 pixels, 
four colors), which work with one of two color palettes which can be selected via 
function OBH, sub-function 1. The EGA BIOS simply loads the corresponding 
colors into the lower three palette registers, depending on the palette selected. 


Tiere is normally no need to change the contents of the palette registers in this 
case, since no new colors can be displayed on the screen. Individual colors can 
easily be exchanged with each other. 


Things are different when an EGA/VGA or multisync monitor is connected. The 
EGA/VGA BIOS loads values 0 to 15 into the 16 color registers when the text 
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mode is initialized, but this does not exhaust the color options of the EGA card. 
To make full use of these options, sub-function OOH of function 10H can be used 
to load one of the 16 palette registers. In addition to the function number in the 
AH register and the sub-function number in AL, this function must also be passed 
the number of the palette (0 to 15) in BH and the new color value for this palette 
in the BL register. Since this function does not check the number of the register, it 
can also be used to change the contents of a 17th palette register (screen border and 
background color in the graphics mode), although it is better to use sub-function 
01H of function 10H for this. Besides, it doesn't make much sense to set a 
background color in the text modes, because the text display takes up almost the 
entire screen with only two or three raster lines left over for the output of a border 
color. The contents of this palette register are ignored when a monochrome 
monitor is connected. 


To call the function for accessing this palette register, the AH register must first 
be loaded with the function number 10H and the AL register with the sub-function 
number 01H. The BH register holds the border color, which is then loaded into 
palette register 16 when the function is called. 


Sub-function 02H of function 10H is used when you want to load all of the palette 
registers at the same time, including the register for the border color. In addition to 
the function and sub-function numbers in AH and AL, respectively, the address of 
a table must be passed in the ES:DX register pair. This table contains the values 
for the 17 palette registers. When this function is executed, the contents of this 
table will be copied into the 17 palette registers and will cause all of the colors on 
the screen to change at once. 


The last sub-function of function 10H (for EGA only) defines the meaning of a bit 
in the text modes. As with the CGA and MDA cards, this bit can also be used on 
the EGA card to emphasize a character by either displaying it on a bright 
background color or flashing it, if the bit is set. While the meaning of this bit can 
be changed only by directly programming the video hardware with CGA or MDA 
cards, the EGA/VGA BIOS can perform the same task using sub-function 03H of 
function 10H. 


As with calling the other sub-functions, the function and sub-function numbers 
must be passed in registers AH and AL. The meaning of bit seven of the attribute 
byte 1s determined by the contents of the BL register. The value of zero in this 
register sets the bright background color, while the value one causes all characters 
on the screen, with bit seven of their attribute bytes set, to flash on and off. 


The VGA card has additional functions available for accessing this table. These 
functions are all sub-functions of function 10H, and are only accessible from the 
VGA card. 


The contents of a single DAC color register can be modified using sub-function 
10H. Load the AL register with the sub-function number, the BX register with the 
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number of the corresponding register (0-255) and the CH, CL and DH registers 
with the color code. Then call the function. To help correctly interpret the contents 
of this register, the DAC color table must be coded as an 18-bit value (6 bits for 
red, 6 bits for green and 6 bits for blue). The red components must be loaded into 
the DH register, the green components into the CH register, and the blue 
components into the DL register. 


You must load the number of the register to be updated into the BX register. The 
registers receive the number of the DAC register to be updated when you call sub- 
function 15H. 


Any number of DAC color registers can be loaded at a time using sub-function 
12H. The number of the first DAC color register to be loaded is passed to the BX 
register, and the number of DAC color registers to be loaded is passed to the CX 
register. The new contents of the DAC color registers are loaded into a buffer (the 
address of this buffer is contained in the ES:DX register pair). Each DAC color 
register receives three consecutive bytes from this buffer. These three bytes specify 
the green components, the red components and the blue components of the color 
code. 


Reading the DAC color table 


Sub-function 17H reads the contents of a group of DAC color registers. The 
number of the first DAC color register to be read is passed to the BX register, and 
the number of registers is passed to the CX register. The contents of this register 
copies the VGA BIOS to a buffer, whose segment and offset address may be found 
in the ES.DX register pair. The structure is identical to that of sub-function 12H. 
Remember that the registers for each DAC color register consist of three bytes (not 
one), and to allocate a buffer of appropriate size. 


Organizing the DAC color table 


Sub-function 13H allows the organization of the DAC color table and the active 
color group, offering two of its own sub-functions. If the BL register contains the 
value 0, then the sub-function copies bit 0 of the BH register into bit 7 of the 
mode control register of the VGA controller. The organization of the DAC color 
table can then be broken down into 4 or 16 groups. However, if the BL register 
contains the value 1 when this sub-function is called, then the sub-function copies 
the contents of the BH register into the color select register, then selects the active 
color group. 


The contents of both registers can be conveyed by calling sub-function 1AH. After 
calling this function, the content of bit 7 of the mode control register is passed to 
the BL register, and the contents of the color select register is passed to the BH 
register. 
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Gray scales 


Palette 


Sub-function OBH converts the color codes within the DAC color table into gray 
scales. Pass the number of the first register to be converted into the BX register, 
and the number of registers to be converted to the CX register. The conversion 
results in a color value between 0 (black) and 1 (white), based on a red intensity of 
30%, a green intensity of 59% and a blue intensity of 11%. 


registers 


The VGA BIOS still has more sub-functions in function 10H for reading the 
palette registers. Sub-function 07H reads the contents of any palette register. When 
the function is passed and the number of the palette register is passed to the BL 
register, the number of the contents is returned in the BH register. This allows read 
access to the contents of the overscan register (the color border on palette register 
16), but this access requires the use of sub-function 08H. Like sub-function 07H, 
the result is loaded into the BH register. 


Sub-function 09H loads the contents of the entire palette table (i.e., all 16 palette 
registers and the overscan registers) into a 17-byte buffer. The segment address of 
this buffer is loaded into the ES register, and the offset address is loaded into the 
DX register. 


Another feature of the EGA and VGA cards are their ability to work with a number 
of different fonts and font sizes. This feature allows the EGA/VGA cards to be used 
with different monitors, in different resolutions. Since the screen resolution is 
determined by the monitor hardware and cannot be changed, the video card must 
adapt to the monitor's resolution. Exceptions to the rule are the more versatile and 
expensive multisync monitors, which get their name from the ability to adapt 
themselves to different synchronizations (resolutions). 


Of the different monitors which can be used in connection with an EGA or a VGA 
card, the color monitor, normally used in conjunction with a CGA card, has the 
poorest resolution. It orily has a resolution of 640 pixels (horizontal direction) by 
200 pixels (vertical direction). If you want to display 25 lines of 80 columns each 
on the screen, you will have to use a character matrix of 8 by 8 pixels so that all 
of the characters fit on the screen. 


Even though the monochrome monitor cannot display different colors, it does offer 


_ a resolution of 720 by 350 pixels when used with an MDA or Hercules graphics 
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card. The individual characters are displayed with a matrix of 9 by 14 pixels. 


EGA and multisync monitors also have a vertical resolution of 350 pixels, but can 
only display 640 pixels horizontally. The resolution of individual characters is 8 x 
14 pixels—only slightly less than that of the monochrome monitors. VGA cards 
and multisync monitors usually support a minimum vertical resolution of 480 
pixels, but some units even support 600 raster lines. VGA cards often permit 
character matrices of 8x16 (text mode) and 9x16 pixels. — 
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Character generators 


In order to support the various resolutions, the EGA/VGA cards have their own 
character generators which can display characters in any height between one and 32 
raster lines. The number of text lines per screen depends on the height of the 
displayed characters and the resolution of the monitor. To make the best use of this 
feature, the EGA/VGA cards get the bit patterns of the characters from a section of 
the video RAM instead of from ROM. 


Function 11H 


Normally the character generator is programmed automatically and the appropriate 
character set is loaded when a video mode is initialized, but it is possible for a 
program to control these features with function 11H. You might want to use this 
to display more than the usual 25 text lines on a monochrome, EGA, or multisync 
monitor. But even if you do want to use 25 lines, these functions offer the ability 
to redefine individual characters of the character set or to install an entirely new 
character set. This can be done with sub-function OOH. Like all of the sub- 
functions of function 11H, the value 11H must be passed in the AH register and 
the sub-function number must be passed in the AL register. A number of other 
parameters must also be passed in the other processor registers. The BH register 
stores the height of the individual characters. Since this function is intended for 
modifying individual characters of the current character set, you must load the 
height of these characters here. As mentioned above, the height of characters on 
monochrome, EGA, or multisync monitors is normally 14 lines (or with the VGA 
card, 16 lines on a VGA or multisync monitor), while on color monitors it is 8 
lines. The BL register stores the number of the character table in which the 
character will be loaded. Theoretically a number 0 through 3 can be given here for 
one of the four different character tables, but you should restrict yourself to 
modifying character table 0, because it is the only table guaranteed to be accessible 
by EGA cards with less than 256K RAM. This character table is also the one into 
which the EGA BIOS loads the character definitions when the video mode is 
initialized with function OOH. Since you may not want to redefine the entire 
character set, the CX register holds the number of characters to be defined 
(maximum of 256). The number of the first character to be defined is placed in the 
DX register and may not exceed the value 255. 


The character definitions themselves are stored in a buffer whose address is passed 
in the ES:BP register pair. The bit patterns of the individual characters are placed 
in this buffer such that the height of each character (BH register) also specifies the 
number of bytes per character in the buffer. 


The individual characters are stored sequentially, so the total size of the buffer is 
the number of characters multiplied by the height of the characters. The eight bits 
of each byte reflect the status of the individual pixels in each raster line. If a bit is 
set, the pixel will appear at the corresponding position in the foreground color. If 
the bit is cleared, the pixel will appear in the background color. Note that the 
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character matrix is actually eight pixels wide, even through the characters are 
displayed with a width of nine pixels on a monochrome screen. In this case the 
ninth bit is not taken from the character definition, the last bit on each line 1s 
simply duplicated. 


Bit 


ES:BP ——> @——— First character 


00111000b 
00111000b 
00010000b 
11111110b 
00010000b 
00101000b 
01000100b 


O0000000b 
@Q—§— Second character 


oes oe 


Buffer structure after calling function 11H, sub-function OOH 


As long as characters with the appropriate ASCII codes are displayed on the screen, 
the changes will be noticeable immediately after this function 1s called. 


While sub-function OOH can be used to load user-defined characters into the 
character set, sub-functions 01H and 02H are used to load the two ROM character 
sets contained on the EGA/VGA card. Sub-function 01H loads the entire 8x14 
character set of the EGA/VGA card into one of the four character tables. Sub- 
function 02H loads the 8x8 CGA-compatible character set into one of the four 
character tables. In addition to the function and sub-function numbers, both 
functions are passed the number of the character table in which the character set is 
to be loaded in the BL register. If the character table involved is the one currently 
displayed on the screen, then the changes will be visible immediately after the 
function is called. Although these two functions load the character sets, they do 
not set the character generator to the height of the appropriate character set. For 
example, if you load the 8x8 character set into the current character table while the 
characters are being displayed in an 8x14 matrix, you will get a rather strange 
display. Raster lines one to eight will have the bit-map of the 8x8 character set 
while lines nine to 14 will have the remainder of the 8x14 set. 


Sub-function 04H (available to VGA only) serves a similar purpose to sub- 
functions 01H, 02H and 03H. The difference is that calling sub-function 04H loads 
the 8x16 ROM character set into one of the four character tables. 
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If you want to work with several character sets in parallel, it is recommended that 
you load the individual character sets into their own character tables and then 
switch between the tables. Sub-function 03H is used to switch to a new character 
table. In addition to the function and sub-function numbers, it must be passed the 
number of the character table to be activated in the BL register. 


Sub-functions 10H, 11H, and 12H are almost identical to sub-functions 00H, 01H, 
and 02H. They are also used for loading character sets, but they program the 
character generator at the same time. This has the result that the characters are 
displayed with the proper character height after the function is called. The number 
of text lines on the screen changes automatically. 


Function 10H is used to load and activate user-defined character sets and is called 
exactly like function 0OH. The number of text lines which are displayed after the 
call to the function results from the vertical resolution of the monitor divided by 
the height of the individual characters. If this division is not even and there is a 
remainder, the remaining lines will be divided equally between the top and bottom 
borders of the screen. Partial text lines are not displayed. 


Sub-functions 11H and 12H load and activate entire character sets. If the 8x14 
character set is loaded with sub-function 11H and a monochrome, EGA, or 
multisync monitor is being used, 25 lines (EGA) or 28 lines (VGA) will be 
displayed on the screen. If this is done while a color monitor is connected, which 
has a vertical resolution of only 200 lines, only 14 lines will be displayed on the 
screen. 


These changes must also be taken into account when calling function 12H, which 
loads and activates the 8x8 character set. The usual 25 lines will be visible on a 
color monitor, while on the other monitors the screen will consist of 43 text lines 
(EGA) or 50 text lines (VGA). 


VGA BIOS has an additional sub-function. When sub-function 14H is called, it 
loads and activates the 8x16 ROM character set. Only 25 lines of text will appear 
on the screen. 


Regardless of the number of text lines which result from calling one of these 
functions, the EGA BIOS ensures that the traditional BIOS functions for screen 
output (function numbers OOH to OFH) will still work properly. Even if the screen 
contains 43 lines, you can call the functions for character output, scrolling the 
screen, and access the lines outside of the usual 25-line boundary. However, you 
should avoid using multiple screen pages and just use page 0, or you may run into 
problems with the BIOS versions of various manufacturers. 


Cursor emulation 


Certain EGA cards can have problems with the mechanism called cursor 
emulation. This involves converting the starting and ending lines of the cursor 
when the height of the character matrix is changed. For example, if the character 
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height decreases from 14 to 8 lines, then the cursor will be invisible if it was in 
the range of raster lines from 9 to 14. To prevent this, the BIOS converts the 
starting and ending lines to the new matrix height. This mechanism must be 
disabled at the beginning of a program. Unfortunately, no function for doing this 
exists in the EGA BIOS; the only way to disable it is to clear a flag in one of the 
BIOS variables (bit 0 in the byte at address 0040:0087). The programs at the end 
of this section demonstrate this in practice. The VGA BIOS does possess such a 
function, as we'll see shortly. 


Function 12H 
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All of the functions described so far can only be used in conjunction with an EGA 
card or a VGA card. To determine if an EGA/VGA card is installed, the EGA/VGA 
BIOS offers function 12H, which is not available in the normal ROM-BIOS. It is 
called with the function number in AH and the value 10H in the BL register. If 
this value is still in the BL register after the call, you can assume that no 
EGA/VGA card is available and the normal ROM-BIOS was called, which does not 
support this function. A different value shows that an EGA or a VGA card is 
available. In this case the BH, BL, and CL registers contain configuration 
information about the installed EGA/VGA card. 


The value in BH specifies the video mode that will be activated after the system is 
booted. Since another mode may have been enabled in the meantime, this 
information is of little use. The value in the CL register, which tells you what 
kind of monitor the card is driving, is much more useful. The following values are 
returned for the individual monitor types: 


OBH monochrome monitor 
09H high-resolution (EGA/VGA or multisync) monitor 
08H color monitor 


The contents of the BL register are also useful. They specify the amount of RAM 
installed in the EGA card. The following codes can appear: 


0 64K 1 128K 
2 192K 3 256K 


This distinction is important if you want to work with multiple character tables or 
with the high-resolution graphics modes of the EGA/VGA card. For example, 
graphics mode number 10H, which offers a resolution of 640x350 pixels, can be 
used only if the EGA/VGA card has at least 128K of RAM. The number of 
character tables available also depends on the size of the RAM. This can be 
determined by the incrementing by 1 the number returned in the BL register. 
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Function 1AH 


Function 1AH, sub-function OOH informs the user of whether an EGA card or a 
VGA card is installed. This function is only available to VGA cards. You must 
pass the function number to the AH register and place the value OOH in the AL 
register. This determines whether a VGA card is installed. If the value 00H 
remains unchanged, there is no VGA card available, while a returned value of 1AH 
indicates a VGA card. The contents of the BL register indicate the active video 
mode: 


|_o4H | EGA card / high-res monitor 


Function 12H, sub-function 20H can be used to install an alternate hardcopy 
routine. This can be used when the screen is displaying more or fewer than 25 
lines. Since the normal hardcopy routine of the BIOS assumes that there are 25 
lines on the screen, it always prints exactly 25 lines, which may omit some lines 
from the hardcopy. The alternate hardcopy of the EGA/VGA BIOS always accounts 
for the actual number of lines displayed on the screen, and is therefore preferable to 
the normal hardcopy routine. It is installed by calling the BIOS video interrupt 
10H, whereby the value 12H is passed in the AH register and the value 20H must 
be in the BL register. 


The VGA BIOS includes six other sub-functions of function 12H, exclusively for 
control of the VGA card. Sub-function 30H helps determine the number of raster 
lines available (not text lines) when a VGA is operating with a VGA or multisync 
monitor. In CGA mode this becomes only 2U0 lines instead of 400. The sub- 
function number must be loaded into the BL register. The VGA BIOS interprets 
the number it finds in the AL register as the number of raster lines. A value of 0 
in the AL register indicates 200, the value 1 indicates 350 and the value 2 indicates 
400 raster lines. 


Working in conjunction with color selection as mentioned above, so that EGA and 
VGA cards can load their palettes or DAC registers, the color spectrum of a CGA 
card can be emulated. Sub-function 31H enables or disables this emulation in the 
VGA card after calling function OOH (video mode selection). Calling this sub- 
function signaled by the value 0 in the AL register activates green light, while a 
value of 1 tells the VGA BIOS to avoid loading the corresponding register. 
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Automatic gray scaling 


Sub-function 33H specifies the status of automatic gray scale summing. This 
summing instructs BIOS accesses to the DAC color table to automatically convert 
color values into gray scales. The contents of the AL register indicate this status: 
A value of 0 indicates conversion enabled, while a value of 1 indicates no 
conversion. 


Function 12H, sub-function 34H controls the suppression of cursor emulation. A 
value of 0 in the AL register enables cursor emulation, while a value of 1 
suppresses this emulation. 


Function 13H 
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We will mention one last function of the EGA/VGA BIOS. It is not exactly new, 
since it was already in the AT ROM-BIOS, but it was not in the PC or XT BIOS. 
This is function 13H, which displays a string on the screen. There are four 
different output modes available, which differ in how the string is passed to the 
BIOS and whether or not the cursor will be placed at the end of the string when the 
output is done. Also, the functions differ in whether all the characters in the string 
will be given a constant color or provided with individual attributes. In the first 
case, the buffer, the address of which is passed in the ES:BP register pair, need 
only contain the ASCII codes of the characters to be printed. The color for all of 
the characters is taken from the BL register. In the second case, the attribute byte 
for each character follows its ASCII code in the buffer. 


The contents of the AL register determine which mode will be used: 


0= One color for all of the characters. The cursor position does not 
change. 

l= One color for all of the characters. The cursor will be placed after the 
last character of the string. 

2= The buffer contains the individual attributes. The cursor position does 
not change. 

3= The buffer contains the individual attributes. The cursor will be 


placed after the last character of the string. 


The number of the screen page on which the string is to appear can be specified in 
the BH register, but this should always be the current page. Otherwise problems 
will arise with printing control characters (carriage return, linefeed, etc.). The CX 
register holds the length of the string. This refers to the number of characters to be 
printed (attributes must not be counted in modes 2 and 3). The output position is 
passed to function 13H in registers DH (line) and DL (column). And, finally, we 
shouldn't forget the function number in the AH register. 
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Demonstration programs 


After so many register assignments, function numbers, and the like, it helps to be 
able to see some example programs to put the information into perspective. Many 
of the functions we discussed are found in the programs listed below. Not all of 
them are called by the actual main program but are included to show you how it's 
done. 


The programs have two main tasks. First, they show you how to work with and 
program the color palettes. Second, and even more important, these programs 
show you what possibilities are offered by defining your own character sets. Here 
this is used to display a small graphic in text mode. This could be used when you 
want to display a personal or company logo on the screen, but the characters 
needed are not found in the ASCII character set. In the example program, this is 
demonstrated by displaying the text "PC Internals Michael Tischer" on the screen 
in large, fancy lettering while in text mode. This message was first drawn with a 
graphics program and then converted to a kind of virtual raster. This corresponds in 
density to the character matrix of 8x14 pixels in the text mode when an EGA 
monitor is connected. With the help of this raster we discovered that four rows of 
30 characters each, for a total of 120 characters, were required to display this 
graphic in text mode. The next step was to convert the bit-map of this graphic so 
that it could be loaded into one of the character tables with the help of sub-function 
OOH of function 11H. Each eight consecutive pixels were combined into a byte and 
then 14 of these eight-bit units in a column were combined together. The results 
are the initialized arrays in the program listing. 


Once these data are created, the most time-consuming part of the whole procedure 
is done, since all we have to do is call the appropriate function in order to load the 
characters into the character table so we are able to display them on the screen. 
This proved to be something of a problem in C because none of the functions for 
interrupt calls allowed a value to be assigned to the BP register, which is where the 
offset address of the character buffer must be passed. We had to write a small 
assembly language routine which just loads the parameters passed to it into the 
required registers and then calls the BIOS video interrupt. 


Inside the example program the bit patterns for the graphic are loaded into the 
character definitions for the ASCII codes 128 to 248 with the help of this function. 
The new characters replace the foreign characters and the border characters, but the 
standard ASCII characters like letters and numbers are retained. You can load the 
bit patterns in other parts of the character set as well, if you wish. 


One routine in the program which is not executed is called SetLine and allows the 
number of text lines on the screen to be set (25 or 43). If you use this function to 
put the screen in 43 line mode, you first maKe certain arrangements regarding 
screen output. Both Pascal and C send their output to the screen using DOS 
functions when printf or writeln is called. Turbo Pascal allows direct access to the 
video RAM under certain conditions, but this doesn't change the problem. Here it 
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Pascal 
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depends on whether or not an extended screen driver (ANSI.SYS) is installed. If 
such a driver is not installed, the DOS will use BIOS function OEH of interrupt 
16H, which also handles screen scrolling. Since this function is part of the EGA 
BIOS, it will properly recognize that the screen consists of 43 lines and will not 
scroll it until the 44th line is reached. Things are different with most ANSLSYS 
drivers, which perform scrolling themselves. Since many of them assume a 25-line 
screen, they will scroll until the 26th line is reached and the remaining lines will 
be wasted. 


To avoid such problems, the two output routines in the example programs offer 
the ability to output strings directly to the video RAM and avoid the DOS 
functions. 


listing: EGAP.PAS 


{$V-} { don't check length of strings } 
{ ER KK RRR HKRREKEK KEKE HK KKK HERE EK KKK KKK HERRERA EKKE KEKE KIA KEKREKKEHEKEEK KE } 
{* EGAP *} 
{* ates en chiles nani ess Sent eum nl Sei aps eo ss cts eis ns es aio si as un‘ Ss ems esis cits in’ ni ci un snub seen cme Si cess *} 
{* Description : demonstrates the use of the functions of the *} 
{* EGA/VGA BIOS. se 
{* ‘Lan ‘Sn Sime svi neces usu Ss cs rh mr Sa nes ui crs op ani sam cay Gums temas cee sn eso es a eas eda a ans saa “cus ns ims ck wis mms am sus cas rss is ees amc nin ma Sas ops ces eu ts ais leis Gags cm *} 
{* Author : MICHAEL TISCHER =) 
{* developed on =: 08/30/1988 =} 
{* last update : 06/07/1989 *} 


{ RRR A RRR RIKER HERE IK HK IIH IMIR IAEA AREER KEE EK AREKEK IKKE | 


program EGAVGAP; 


Uses Dos, CRT; { bind in the DOS and CRT units } 
type BytePtr = “byte; { pointer to a byte } 
VElb = record { describes a screen position as 2 bytes } 
Character : char; { the ASCII code } 
Attribute : byte; { the attribute } 
end; 
VRam = array[0..4000] of VelB; { describes the video RAM } 
string8 = string[80]; { output string for PrintAt } 
const VIDEO INT = $10; { BIOS video interrupt } 
LINE25 = 25; { 25 line screen } 
LINE43 = 43; { 43 line screen } 
MOMO = 0; { constants for GetMonTyp } 
COLOR = 1; 
EGA = 2; 


Font : array[1..120, 1..14] of byte = ( 


( 0, 0,255, 62, 28, 28, 28, 28, 28, 28, 28, 28, 28, 31), { E } 
(-0;- 907252, 7y.. De gz By ee, Se. as Ce. 7252) { A } 
( 0, O, O, 0,129,195,195,199,199,206, 206,142, 14, 14), { c } 
( 0, 0, 62,193,128,128, 0, 0, O, O, O, O, O, O), { H } 
( 0, O, 16,144,112, 48, 48, 16, 16, 0, 0, 0, O, O}, { } 
( 0, O, O, O, O, O, O, O, O, O, O, O, O, O), { L } 
( 0, O, 3, 0, :90, O, O, O, O, O, O, 9, O, OO), { I } 
( 0, 0,254,248,112,112,112,112,112,112,112,112,112,112), { N } 
( 0, O, O, O, O, O, O, O, 0,252, 61, 30, 30, 28), { E } 
( 0, O, O, O, O, O, O, O, 0,248, 6, 7, 3, 3), { } 
( 0, 0, O, O, O, O, O, O, O, 7, O, O, 0,128), { Cc } 
( 0, O, 32, 96,224,224,224,224, 224,254,224, 224,224,224), { 0} 
( 0, 0, O, O, O, O, O, O, O, 1, 6, 12, 28, 24), { N } 
( 0, O, O, O, O, O, O, O, 0,240, 28, 6, 7, 7), { T } 
( 0, 0, O, O, O, O, O, O, O, 63, 15, 7, 7, 7), { A } 
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( 0, 0, O, O, O, 0, O, O, O, 30, 39, 71,135,128), 
( 0, 0, 0, O, O, 0, O, 0, 0,126, 30, 15, 15, 14), 
( 0, 0, O, O, O, O, O, O, 0,124,131, 3, 1, 1), 
( 0, 0, 0, O, O, 0, O, 0, O, O, 0,129,131,195), 
( 0, 0, O, O, O, 0, 0, 0, O, 0, 62,193,128, 0), 
( 0, 0, 0, 0, O, 0, O, 0, O, O, 0,192,224,224), 
( 0, 0,248,120, 56, 56, 56, 56, 56, 56, 56, 56, 56, 56), 
( 0, 0, O, O, O, 0, O, O, O, 31, 48, 48, 48, 48), 
( 0, 0, O, O, O, O, O, O, 0,196, 52, 12, 4, 4), 
( 0, 0, 0, O, 0, O, 0, O, 0, 0, 0, 0, O, 0), 
(iO 20p. 205. 04. Oe 205. 0, 202. 0)! 0, ! 0%, +O, <0;.° OY; 
( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) ’ 
CO 05: O- 0, “0, 0,0, “0x. 0; 0, 0; 0,- 0, 0), 
( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), 
C 0;- 0, 0, 0,0,..°0,.. “On <0... 0,- 0, 0; 0; -0.- 0), 
( 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, 0, 0), 
( 0, O, O, O, O, O, O, O, 0,128, 0, O, O, OO), 
C14. 26 ay 69 ee 3 Se AS. Oe 0... Oe 305-05. 0): 
( 0, O, O, O, O, O0,128,128,193, 62, 0, 0, 0, 0), 
( 0, O, O, O, 16, 16, 32, 64,128, 0, 0, O, 0, 0), 
{ 0, 0, 0, O, 0, O, O, O, O, 0, 0, O, O, O), 
( 0, O, O, 9, O, O, O, O, O, 3, O, O, O, OD), 
(112,112,112,112,112,112,112,112,248,254, 0, 0, 0, 0), 
( 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, 0, 0), 
(3, 3, 3). 3) 3 3, 3, 3, 7,359; 0, 0; 0; 0), 
(128,128,128,128,128,128,128,128,192,240, 0, 0, 0, 0), 
(224,224,224, 224,224,224, 96,112, 49, 30, 0, 0, 0, O), 
( 56, 63, 56, 56, 56, 24, 92, 76,134, 1, 0, O, 0, 0), 
( 7,255, 0, 0, 0, 0, 1, 2, 12,240, 0, 0, O, 0), 
CF Tg Dg Tp. “Tye Ts Dy. FS 63, 05-0. 0, . 0); 
( 0, 0, O, O, O, O, O, 0,128,224, 0, O, O, 0), 
(14, 14, 14, 14, 14, 14, 14, 14, 31,127, 0, 0, 0, 0), 
( 1, 1, 1, 1, 1, 1, 1, 1, 3,207, 0, O, O, OQ), 
(192,192,192,193,193,195,195,193, 225,248, 0, 0, 0, 0), 
( 0, 7,120,192,192,128,128,192,195,124, 0, 0, 0, 0), 
(224,224,224, 224,224, 224, 224,240,112, 29, 0, 0, 0, 0), 
( 56, 56, 56, 56, 56, 56, 56, 56,124,255, 0, 0, 0, 0), 
( 31, 31, 31, 0, 0, 64, 96, 96,112, 71, 0, 0, 0, 0), 
( 0,224,248,252, 28, 12, 4, 12, 24,224, 0, 0, 0, 0), 
{ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), 
( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), 
( 0, O, O, 90, 0, O, O, O, O, O, O, O, O, O), 
( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), 
( 0, 0, O, O, O, O, O, O, O, O, O, O, O, OQ), 
( 0, 0, O, O, O, O, O, O, O, O, O, O, O, OQ), 
( 0, 0,252, 60, 30, 30, 30, 23, 23, 23, 19, 19, 19, 17), 
( 0, 0, O, O, O, 0, O, 1, 1, 1,130,130,130,196), 
( 0, 0,126,120,240, 240, 240,112,112,112,112,112,112,112), 
( 0, 0, 28, 28, 28, 0, 0, 0, 0,252, 60, 28, 28, 28), 
( 0, 0, 0, O, O, O, 0, 0, O, 1, 6, 12, 28, 24), 
(0, 0, -0,; “0, -0,. 0; °0,. 0; -0,240,.12-. -2,: 7, 9); 
( 0, 0, 63, 15, 7, 7, 7, Ty, Ty 7, Ty 7, TF, 7), 
( 0, O, O, O, O, O, O, O, O, 62, 65,129,128, 0), 
( 0, 0, 0, 0, 0, O, 0, 0, O, 0,128,192,192,224), 
( 0, 0, O, O, O, O, O, O, O, 63, 64,224,224, 224), 
( 0, 0, 0, 0, O, 0, 0, O, O, 0,192, 96,112,112), 
( 0, 0, O, O, O, O, O, O, O, 7, 24, 48,112, 96), 
( 0, 0, 0, O, 0, O, O, O, 0,192,112, 24, 28, 28), 
( 0, 0,252, 60, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28), 
( 0, O, O, 0, O, O, O, O, O, O, O, O, O, O), 
( 0, O, O, O, O, O, O, O, O, O, O, O, O, O), 
( 0, 0, 63, 56, 48, 48, 32, 32, 32, 0, 0, O, O, O), 
( 0, 0,255,112,112,112,112,112,112,112,112,112,112,112), 
( 0, 0,225,225, 97, 32, 32, 32, 32, 15, 3, 1, 1, 1), 
( 0, 0,192,192,192, 0, 0, 0, 0,192,193,195,195,195), 
( 0, O, , 0, O, O, O, O, 0,252, 3, O, O, O), 
( 0, 0, 0, O, 0, O, O, 0, O, 64, 65,195, 71, 70), 
( 0, 0, 0, 0, O, 0, O, O, 0,124,131, 0, 1, 1), 
( 0, O, 15, 3, 1, 1, 1, 1, 1, 1, 1,129,193,193), 
( 0, 0,192,192,192,192,192,192,192, 207, 208, 224,224,192), 
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7. The BIOS PC System Programming 


( O, O, O, O, O, O, O, O, O,128, 96,112, 48, 56), { B } 
( O, O, O, O, O, O, O, O, O, 3, 12, 24, 56, 48), { M } 
( 0, O, O, O, O, O, O, O, O,224, 56, 12, 14, 14), { - } 
( O, O, O, O, O, O, O, O, 0,126, 30, 14, 15, 15), { P } 
( 0, O, oO, O, O, O, O, O, O, 60, 78,142, 14, 0), { Cc } 
(17, 17, 16, 16, 16, 16, 16, 16, 48,254, 0, 0O, OQ, OO), 
(196,196, 232, 232,232,112,112, 80, 32, 35, 0, O, O, OO}, 
(112,112,112,112,112,112,112,112,248,254, 0, 0, O, O), 
( 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, O, O, O}, 
( 56, 56, 56, 56, 56, 24, 28, 12, 6,129, 0, O, O, OQ), 
C Te. Oy, -0; Op. - 0, OF “Le. 2, 12,240; 0, Oy -0,- -0), 
© Ty Ve Ve Te Te Te Ty Te 18,63, Oy Of. 0, “O}y 
( 0, 0, QO, 0, 0, O,. 0, .0,129,231, 0,. 0, 0, 0); 
(224,224,224, 224,224, 225, 225,224,240,252, 0, O, O, QO}, 
( 0O, 3, 60,224,224,192,192,224,225, 62, 0, OO, O, OO), 
(112,240,112,112,112,112,112,120,184, 14, 0, O, OQ, QO), 
(224,255, 224, 224,224, 96,112, 48, 24, 7, 0, O, O, O), 
( 28,252, 0, 0, O, O, 4, 8, 48,192, 0, 0, 9O, OQ), 
( 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, OO, O, O), 
C.D, Op “0%. 0, 0p “05. 0;:.- 05. 07128, 0; “0, Oy. OF; 
( 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0), 
({ 0, O, O, O, O, O, O, O, O, 3, O, O, OO, O), 
(112,112,112,112,112,112,112,112,248,254, 0, 0, O, O)}, 
( 1, 1, 4d, 1, 1, 1, 1, 1, 3, 15, 0, O, O, O), 
(193,193,192,192,192,194,195,195,227,250, 0, O, O, OO), 
(240,254,255, 15, 1d, 0, .0,. 0,129,126, 0, 0; ‘0; .@), 
{ 14, 14,142, 206,206,198, 71,195,129, 0, 0, O, O, OO), 
€ ky Oy. Op  O, OQ, Oy 0, 0,191,124, 0, 0, “Oy, 0}, 
(193). Pye. de!) ye “Uge hy 6571295. . 37-8: OR. Oy “Oy. “0, 
(192,192,192,192,192,192,192,192,224,249, 0, O, O, OQ), 
(56, 56,56, 56, 56, 56,56, 56,124,255, . 0, 0, 0, 0), 
(112,127, 112,112,112, 48, 56, 24;.12,-. 3, ‘0%. 0; Oe -O},y 
(14,254, 0, O, O, O, 2, 4, 24,224, O, O, O, OQ), 
(14, 14, 14, 14, 14, 14, 14, 14, 31,127, 0, 0, O, QO), 
C0, “0, 03. 0, Op 0,7; (03. Oy -°0,192;- (0%. 07 0, 0) 04 

var VLine{VLine}, { stores the current cursor position } 
vcolumn{VColumn}, 
NumLine{NumLine} : byte; { number of screen lines } 
Mono : boolean; { TRUE, if monochrome monitor } 


{ FREAK KEKE KKK KEKK EKER KEKE KKK KKK KKK KKK KEK KKK EKER KKKEKEKKEKEKEKKKEKEKEKEKKKKE | 


{* CEmul: Switches the cursor emulation of the EGA card on or off. *} 
{* Input : - DOIT = TRUE : Cursor emulation on. *} 
{* FALSE: Cursor emulation off. le 
{* Output : the current cursor column * 


{ RRR RRR KERR KKK KK RK KER KEKE ERK KKK EKER ERK RK KKK KKK ERE KKK KER ERK KEK ERKEKKK KEKE | 


procedure CEmul( DoIt : boolean }); 


var VioInfoByte : byte absolute $0040:$0087; { BIOS info byte } 
begin 
if DoIt then { turn emulation on? } 
VioInfoByte := VioInfoByte or 1 { yes, set bit 0 } 
else { NO } 
VioInfoByte := ViolInfoByte and 254 { mask out bit 0 } 
end; 


{RARER ERK KARR RRR KKK RK RRR RRR RHE K RE KARE IKKE KE RRR EKER EK KKK KKK KEKK EE } 


{* GetCS: Returns the current output column. Bs 
{* Input : none *) 
{* Output : the current cursor column so 


{KER RRR KKK EEK KK KEK KKK ERK HERE RR K EK KKRK KR KK AK KKEKKKK KKK AKKKKERKEKKKK KKK | 


function GetCS : byte; 
begin 


GetCS := VColumn; { get column from global variable } 
end; 


272 


Abacus 7.4 BIOS Screen Output Functions 


{ HERR RREK KEKE KKK EK KKK KEK K RK KR KEK RK K KKK KEK KEKE KKK KKK KREKHKEEKREKKEKKEKEKEKEKKK } 


{* GetCZ: Return the current output line. =} 
‘{* Input : none *} 
{* Output : the current output line *} 


{ FERRER KKK RK KEK KKK KKK RE KIRK K RE KEK ERK KEK KEK KK REE KEK KEK KKK K KKK EKKKKEKKE } 


function GetCZ : byte; 


begin 
GetCZ := VLine; { get line from global variable } 
end; 


{ BARAK RIKER RRR RRR KEK RK KKK KER KKK RIKER KKK KKK KEKE KKK ERK KEK KKK KEKKKE KER } 


{* CharDef: Defines the bit pattern of an individual character. *} 
{* Input : - ASCII = ASCII code of the first char to be defined *} 
{* ~ TABLE = number of the character table ( 0 bis 3 ) *} 
{* - MATRIX = number of lines in the character matrix *} 
{* - NUMBER = number of characters to be defined x} 
i - BUFPTR = pointer to the buffer with the character *} 
{* Output : none x} 


{ BAKKER KKK KERR HK K KKK KKK KKK IKKE ERK KKK KEKE KEK KKKKEKKEKKKKEKEKKAKEKKAKKKKKKE | 


procedure CharDef( Ascii, Table, Matrix, Number : byte; 
BufPtr : BytePtr ); 


var Regs : Registers; { processor registers for interrupt call } 

begin 
Regs.ax := $1100; { ftn. no.: character generator, subftn. 0O } 
Regs.bh := Matrix; { line height of the matrix } 
Regs.bl := Table; { number of the character table } 
Regs.cx := Number; { number of the character to be defined } 
Regs.dx := Ascii; { first character to be defined } 
Regs.bp := Ofs( BufPtr% ); { offset address of the buffer } 
Regs.es := Seg( BufPtr’% ); {segment address of the buffer } 
intr (VIDEO INT, Regs); { call BIOS video interrupt } 

end; 


{RRR HIRI RR RRR KKK RRR RH KIRK KKK KKK KKK KKK IKK KKK KIKI KKK KKK KEKKKKK KKK | 


{* GetMonTyp: Determines the type of monitor attached. =) 
{* Input : none =} 
{* Output : the monitor type: MOMO = monochrome monitor = 
{ COLOR = color monitor 7} 
{* EGA = EGA or Multisynec monitor *)} 


{ RRR KARR KEK HK KKH KK KKK KEK KKK KKK KKK KK EEK KK KKK KKK KKK KEKE KEKE KKK KK KKK } 


function GetMonTyp : byte; 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $12; { ftn. no.: get configuration } 
Regs.bl := $10; { subfunction number } 
intr (VIDEO_INT, Regs); { call BIOS video interrupt } 
case Regs.cl of { CL contains the monitor type} 
SOB : GetMonTyp := MOMO; { monochrome monitor } 
$08 : GetMonTyp := COLOR; { color monitor } 
$09 : GetMonTyp := EGA; { EGA monitor } 
end; 
end; 


{ FHA RH HARK K KR KK IK KIKI K KKK KKK HK KIKI KI KIKI KK KKK II KKK IKK IK IKI KIKI KK KKK 


{* SetCur : Sets the blinking cursor and the internal output position *} 


{* Input : - COLUMN = output column (0... 79 ) *) 
{* - LINE = output line be cee. *} 
{* Output : none *} 


{FARRAR RAK KAKA KKK KKK KEK KEKE RE KEK EKER KKK EKER KER ERE KEKERERER KEKE ERE KEK | 


procedure SetCur( Column, Line : byte ); 
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var Regs : Registers; { processor registers for interrupt call } 


begin 
Regs.ah := $2; { ftn. no.: set cursor position } 
Regs.bh := 0; { screen page 0 } 
Regs.dh := Line; { set coordinate } 
Regs.dl := Column; 
intr (VIDEO_INT, Regs); { call BIOS video interrupt } 
VLine := Line; { save coordinates in internal variables } 
vcolumn := Column; 

end; 


{RRR ERK RIK RIK KEI K KK IK KEK KEK KKK KKK KKK EK KEK KEK KEKE KKEEKEK KEKE | 
{* SetCol : Defines the contents of one of the 16 color registers in *} 


{* the EGA card. *} 
{* Input : - REGNR = number of the color register *} 
{* - COLOR = color value (0 to 63) *} 
{* Output : none *} 


{RAK IKIRIKKIKHKHIK KKK KEKE IK KKK ERK IKK KKK KEKE KKK EKKKKKKAKKEKRKKKKKKKKE | 


procedure SetCol(regnr, color : byte); 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $10; { ftn. no.: set colors/attributes } 
Regs.al := 0; { subfunction 0 } 
Regs.bl := regnr; { set number of the register } 
Regs.bh := color and 63; { set color value (mask out bits 6 and 7) } 
intr (VIDEO_INT, Regs); { call BIOS video interrupt } 
end; 


{ARKH RK RRR RRR ERR RRR RRR KKK KIRK RK KKK RRR KKK RAKE KKK KKK ERK KKK KEKKEKRKEKEKEE | 


{* SetBorder : Defines the border color. x) 
{* Input : - COLOR = color value (0 to 63) -) 
{* Output : none ie 


{ RRR RK RAK K EERE KKK KKK HK KKK KEK IKKE KEKE KEK AK KEKE KEKE KKK KKK KEKEEKKEKKKE } 


procedure SetBorder(color : byte); 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $10; { ftn. no.: set colors attributes } 
Regs.al := 17 { subfunction 0 } 
Regs.bh := color and 63; { set color value (mask out bits 6 and 7) } 
intr(VIDEO_ INT, Regs); { call BIOS video interrupt } 
end; 


{ RRR HK KRHA KKK KKK ERK RIKER RK IKK EK IRI IIE RAEI ARAKI EAH EKER EE KEKE KEKE EKEEE } 


{* SetLines : Sets the number of lines. a 
{* Input : Sub-function of function 11H: *} 
1 $11 : 8x4 character set *} 
i $12 : 8x8 character set *} 
lag $14 : 8x16 character set *} 
{* Output : none *} 


{ RRR RRK KKK KKK KKK KKK EK KKK KKK KKK KKK KEKE KEKE KEKE KKK KEK KEK EEK KKKKKKKE | 


procedure SetLines( Lines : byte); 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $11; { ftn. no.: character generator } 
Regs.al := Lines; { sub-function of fnce. 11h } 
Regs.bl := 0; { use character table 0 } 
intr(VIDEO_ INT, Regs); { call BIOS video interrupt } 
end; 
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{ RA RARER RRR RRR ERIK IIR KKK KEKE KEKE KKK RRR EK KIA KEKE KEK EKEEEKKE | 


{* IsEga: Determines if an EGA card is installed and handles the *} 
{* initialization of the global variables. | 
{* Input : none *} 
{* Output : TRUE, if an EGA card is installed, else FALSE. *} 


[RRR KER E KERIKERI KR KERRIER EK KKK IK KARE KARE EK KEKE KREK KKK KKEKEKEKRE | 


function IsEga : boolean; 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $12; { ftn. no.: get video configuration } 
Regs.bl := $10; { subfunction number } 
intr (VIDEO INT, Regs); { call BIOS video interrupt } 
if Regs.bl <> $10 then { is it an EGA or VGA card? 
begin { yes } 
{*- create pointer to VRAM depending on the monitor connected -*} 
Mono := Regs.bh = 1; { connected to monochrome monitor? } 
IsEga := TRUE? { an EGA card was discovered } 
end 
else 
IsEga := FALSE; { no EGA card discovered } 
end; 


{RAH RRR RH HK HK IKK KKK KK I KI IKK KEKE IKEA HAKKAR EKK IKK KKKIEKE | 


{* IsVga: Determines whether a VGA card is installed, and initializes *} 


{* the global variables. a 
{* Input : none *} 
{* Output : TRUE if a VGA card is installed, otherwise FALSE. *} 
{* Info : Use this function BEFORE calling the ISEGA in your own *} 
{* application, since the TRUE for some EGAs also applies x} 
{* to this routine as well. *} 


{BR RI RIK KIRK KKK KI KKK HRI KIKI AK KIKI KK KKK IK KKK KKK KEK EKER EKEKEK KKK KK } 


function IsVga : boolean; 


var Regs : Registers; { processor register for the interrupt call } 
begin 
Regs.ah := $1A; { function no.: Determine video system } 
Regs.al := $00; 
intr (VIDEO INT, Regs); { Call BIOS video interrupt } 
if ( Regs.al = $1A ) and (( Regs.bl = 7) or ( Regs.bl = 8 )) then 
begin { VGA card installed and active } 
Mono := FALSE; 
IsVga := TRUE; { definitely a VGA card on board } 
end 
else 
IsVga := FALSE; { no VGA card connected } 


end; 


{ BEARER HEHE ERK EKER KEE KR EKKEKE KKK KKK KEKKKKREKKKEKKEKEKKKEKEKKKEEKEKKKEEKEK | 


{* PrintAt: Outputs a string at the give screen position with a *} 
{* certain attribute. *) 
{* Input : -—- COLUMN = output column (0... 79 ) =] 
1 * - LINE = output line ( 0 .. NUMLINE-1 ) *} 
{* - COLOR = attribute for the characters to be printed * } 
{* - OUSTR =the string to be printed *} 
{* Output : none *} 


{ BRR KAR RHA RRR IKK HHH IKK KIRK KKK IKKE IK KKK KKK KAI IKKE ERE KKHEKKKKK | 


procedure PrintAt( Column, Line, Color : 
byte; OutStr : string8); 


var ColorRAM : VRam absolute $B800:0000; { describes physical VRAM } 
MonoRAM : VRam absolute $B000:0000; { describes physical VRAM } 
Index : word; { index into the VRAM array } 
Stren, { length of the string to be printed } 
1 : byte; { running pointer to the string } 
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7. The BIOS PC System Programming 
begin 
Stren := length( OutStr ); { get length of the string } 
Index := Line * 80 + Column; { set index in the array } 
if Mono then 
begin { yes } 
for i:=1 to Stren do { run through the string } 
begin 
MonoRAM[ Index ].Character := OutStr[{i]; { set character } 
MonoRAM[ Index ] .Attribute := Color; { set color } 
inc( Index ); { increment the index } 
end; 
end 
else { output to the color screen } 
begin 
for i:=1 to Stren do { run through the string } 
begin 
ColorRAM[ Index ].Character := OutStr[i];{ set character } 
ColorRAM[ Index ].Attribute := Color; { set color } 
inc( Index }; { increment the index } 
end; 
end; 
{*-- calculate new cursor poSitiOn ------------ 99 n nn *} 
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SetCur((VColumn + VLine * 80 + Stren) mod 80, 
(VColumn + VLine * 80 + Stren) div 80); 
end; 


{ RRR KKK KKK KEK KK KEK EKER EKER KEK KKK KKK KKK KKK KEKE KKK KKK KKK EKKKKEKKE RE } 


{* Blinking : Defines the meaning of bit 7 in the attribute of a *} 
{* character in the text modes. *} 
{* Input : - DoBlink = TRUE : blinking x} 
{* FALSE: intense background color *} 
{* Output : none *} 


{ERK KK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KEKE KEK KKK KR KEKKKEKKEKKEKE KEKE | 


procedure Blinking( DoBlink : boolean ); 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $10; { ftn. no.: set colors/attributes } 
Regs.al := $3; { subfunction number } 
if DoBlink then { blinking? } 
Regs.bl :=1 , { yes, BL = 1 : blinking } 
else _ { no } 
Regs.bl := 0; { yes, BL = 0 : intense background color } 
intr (VIDEO_INT, Regs); { call BIOS video interrupt } 
end; 


{ RHA K EHH KKK ERK KKK KEK KKK RK KIEKKEKKKKEKK KKK KEKE R EEK KEE KK KEKKKERKEKKKEKKKEKE } 


{* Cls: Clears the screen, causing the video mode to be reset. *} 
{* The palette registers will also be filled with the default *} 
{* values and the character set will be reset. =} 
{* Input : none *} 
{* Output =: none ie a 


{LAE KKKKKKKKEKKERKK KEK KKK KEKKKKKKKEKKEKK KKK KKK KKK KKKKKKKKKKKEKKEKKKEKKKEKKKKKKKE | 


procedure Cls; 


ee ee) 


var Regs : Registers; { processor registers for interrupt call } 
begin 
Regs.ah := $0; { ftn. no.: set video mode 
if Mono then { connected to monochrome monitor 
Regs.al := 7 { yes, 80x25 text display 
else { no, color monitor 
Regs.al := 37 { yes, 80x25 character text display 
intr (VIDEO_INT, Regs); { call BIOS video interrupt 
end; 


Abacus 7.4 BIOS Screen Output Functions 


{RAR KR KHIR IRR IIH IK KIKI KKK KI KKK EKER IKKE KEKE KKK EK KKK KR KEEK KKK KK | 
{* EgaVga : Demonstrates how to use the functions of the EGA/VGA BIOS.*} 
{* Input : TRUE if VGA card installed, otherwise FALSE *} 


{* Output : none *} 
{RRA RI RH RRR RK KK RK RRR K IK KKK RK KR KKK ERKEKKKEKER | 


procedure EgaVga (VGA : boolean); 


var i, j, k : word; { loop counter } 
OutStr : string8; { logo output string } 
Regs : Registers; { processor register for the interrupt call } 
begin 
{*-- Add EGA/VGA hardcopy routine *} 
Regs.ah := $12; { alternate select function } 
Regs.bl := $20; { sub-function: install rtne } 
intr (VIDEO_INT, Regs) ; { call interrupt } 
{*-- prepare screen layOUt ---------- nn rn rn rrr *} 
SetCur (0, 0); 
Cls; { clear the screen } 
Blinking( FALSE )}); { light background instead of blinking } 
if ( VGA ) then { Check compatibility in case characters must be } 
begin { redefined, and the characters must be changed } 
Regs.ah := $12; { into 350-line mode (changed back into EGA } 
Regs.bl := $30; { mode}. } 
Regs.al := 1; 
intr (VIDEO _ INT, Regs); { call BIOS video interrupt } 


SetLines( $11 ) { activate 8x14 character set } 


ve 


end; 
CharDef (128, 0, 14, 120, BytePtr(@font})); { define character } 
for i:=1 to 250 do { run through the loop 500 times } 
begin { write color bars to the video RAM } 
PrintAt (GetCs, GetCZ, ((i mod 14) + 1) shl 4, ! ays 
if i <> 250 then { last color bar? } 
PrintAt (GetCs, GetCZ, 0, ' ‘} 3 { no } 
end; 
for i:=10 to 15 do { make room for logo } 
PrinTat(22, i, 0, ' ae 
k := 128; { first character in logo } 
for i:=0 to 3 do { the logo consists of 4 lines } 
begin 
OutStr>s= *'> { empty the string } 
for j:=1 to 30 do { each line consists of 30 characters } 
begin 
OutStr z= OutStr + chr( k ); { append the char to the string } 
inc( k ); { increment K } 
end; 
PrintAt (24, i+11, 15, OutStr); { output the string } 
end; 
PrintAt (1, 1, 15, ' The most important characters are et ar 
PrintAt (1, 2, 15, ' still present in spite of the logo! '); 
Printat(1, 3, 15, ' a 
Printat (1, 4, 15, ' !"#S%&e'* ()*+-./0123456789:;<=>2?@ '); 
Printat (1, 5, 15, ‘ ABCDEFGHIJKIMNOPQRSTUVXXYZ[\]*_ '); 
Printat (1, 6, 15, ‘ ‘abcdefghijklmnopqrstuvxyz{|[}~ ‘')? 
Printat (33, 21, 15, ' *)3 
Printat (33, 22, 15, ' press any key to end the program. ")? 
Printat (33, 23, 15, ' ‘)3 
SetCur (34, 22); 
{*-- change the colors in the color bars -------------------------- *} 
i := 0; { start value for the color registers } 
while ( not KeyPressed ) do { repeat until key is pressed } 
begin 
inc( i ); { increment the color value for the first register } 
for j:=1 to 14 do { run through registers 1 to 14 } 
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SetCol(j, i+j and 63); -{ write color value in the register } 
end; : 
if ( VGA ) then { Switch VGA card back into 400-line mode } 
begin 
Regs.ah := $12; 
Regs.bl := $30; 
Regs.al := 2; 
intr (VIDEO_INT, Regs); { call BIOS video interrupt } 
SetLines( $14 ); { activate 8x16 character set } 
end; 
Cls; . { clear screen } 


end; 


[RRR RE RK KR KK EK EK ERK RRR ERK KEKE KEKE KER KKK EEK ER EEK EKKK KKK EREKKEEKKKKE } 


{*% MAIN PROGRAM 2) 


{BERR RRR RRR KERR KKK RK KR KEK EK KEK KKK EERE EK KEKE ERK KKEKKEEKEEKRKEKKEKEKKKKKKK | 


begin 
if IsVga then { VGA card installed? } 
_ EgaVga( true ) { YES, run demo } 
else 
begin 
if IsEga then ” y { EGA card installed? } 
begin { YES } 
if ( GetMonTyp = EGA ) then { EGA monitor attached? } 
EgaVga( false ) { YES, run demo } 
else { NO, wrong monitor } 
begin 
writeln('This program only works with an EGA ‘); 
writeln('card or VGA card, and a monitor ae 
writeln(‘supported by one of these cards. *)? 
end; 
end 
else 
writeln( 'No EGA or VGA card installed...'+ 
‘ Program aborted.' ); 
end; 


end. | 7 S. 
C listing: EGAVGAC.C 


[RRR RRR KKK IKK KEI IK KKK KKK KIRK IKKE IKK KEK KK KKK IKK KIRK / 


/* EGAVGAC */ 
/* ee ee a ce aes A ee Se MD GS wee RE mE SD MY MN AE SOND AE ND SN RE GEE GES MD SEED nD GED sd SD Mn Sem em nn Mn Gem Sh Sn te Mine Gem Kam te Gen Sm ee San SEND ME ie Stn tn oom eu camD cm cu am cam ine x/ 
fy Task > Demonstration using the functions available wf 
/* in the EGA-/VGA-BIOS | a} 
/* a em cain eae ee te Se SD En GE GED ROD Ma GD NS ED te wee Ske GaN SEED amt UD SoD GEE E> Sete its EE Sh DD GORD SOND STD SEE GND ED ED ED cn) EE nse Me SND cen SOD Sse stn site sein eun® mu Gin SEN ou aEED cE com emia same enn sn */ 
[= Author : MICHAEL TISCHER */ 
{* Developed on : 08/30/1988 ld 
i” Last update : 05/02/1989 7. 
/* ee ce ee a AU ne DD SD GD tn SS SOND SY me SA GD ED SU OD Sh GE MD GD GED SEED ND wie GOD SnD Sete eee Sth eve Mem EE Guth GD uD > esse ch > MND can Get NT MOND ib Dm Me mu cae i> eumD ED ame cnn ete une eae */ 
{s (MICROSOFT C) */ 
{* Creation : CL /AS /c EGAVGAC.C a/ 
[* LINK EGAVGAC EGAVGACA; * 7. 
/* Call : EGAC */ 
| Bem nn nn nn nn rn ne nee iad 
[* (BORLAND TURBO C) */ 
/* Creation : Make a project file containing the following: */ 
/* ; EGAVGAC *7. 
fe EGAVGACA. OBJ */ 
/* Before compiling, select the Options menu -/ 
{> and the Compiler option - make sure that the */ 
/* Small model is active sit f 
/* Select the Linker option - make sure that the */ 
/* Case~sensitive link is set to Off i f 
{* The program will compile with one warning... */ 
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/* this is okay, it will run correctly */ 
[RRR RK KKK KKK KEKE RK KEKE KKK KEI KKK KEKE KEKE KEKE KKK KEK ERE KKEKREKKEKKKEEEEK / 


#include <dos.h> 
#include <stdlib.h> 
#include <string.h> 
#include <stdarg.h> 
#include <bios.h> 


typedef unsigned char BYTE; /* Create a byte */ 
typedef unsigned int WORD; 
typedef BYTE BOOL; /* like BOOLEAN in Pascal */ 


typedef struct velb far * VP; /* VP = FAR pointer to the video RAM */ 
/*== Function definition from the assembler module ===================% / 


extern void chardef( BYTE ascii, BYTE table, BYTE lines, 
BYTE amount, BYTE far * buf ); 


struct velb { /* Describes a two-byte position on the screen */ 
BYTE ascii code, /* ASCII code */ 
attribute; /* Corresponding attribute */ 

}e 
/*-- MK FP creates a FAR pointer to an object out of a --------------- */ 
/*-- segment address and an offset address ------------~--------------- */ 
#ifndef MK FP /* MK FP not defined yet? */ 


#define MK FP (seg, ofs) ((void far *) ((unsigned long) (seg) <<16] (ofs))) 
fendif 


#define VOFS(x,y) ( 80 * (y) +(x) ) /* Offsetpos. in video RAM */ 
#define VPOS(x,y) (VP) ( vptr + VOFS( x, y ) ) /* Pointer in VRAM */ 
#define GETCZ () (vline) /* Returns the current cursor line */ 
#define GETCS (} (vcolumn) /* Returns the current cursor column */ 


#define TRUE (1 == /* Constants for working with BOOL */ 
(cd 


a 
#define FALSE == 0 ) 
#define VIDEO INT 0x10 /* BIOS video interrupt */ 
#define MONO 0 /* Monitor types for GETMON */ 
#define COLOR 1 
#define EGA 2 


#define PAUSE 100 


VP vptr; /* Pointer to the first character in video RAM */ 

BYTE vline, /* States the current cursor position */ 
vcolumn; 

BOOL mono; /* TRUE if a monochrome monitor is connected */ 


[RRR KEK EEK EEK KKK KKK KKK KK KKK KKK KKK KEK KEK KKK KEKE KK EEK KEKKKKKAKKKER 


* Function :CEMUL * 
Ve: i ci mis cain Sack a ea eo ens any ssc kas i Gus ies sca“ ab Geks Ges ns “id ees tows i ei de: us iss iss isms Ses Cs es ncn ccs chin bs cls ite ns Gaus ands os ts css a i: iS i ls: i om zk 
* Task : Enables/disables cursor emulation on the * 
* EGA card. ia 
* Input parameters : - DOIT = TRUE : Emulation on * 
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x FALSE: Emulation off * 


* Return values : None = 
KRKK KKK KKK KEK KKK KKK KEKE RK KEKE KEKE EEE KKKKEKE / 


void cemul( BOOL doit ) 

{ 
/*-- Definition of video info byte at offset address 0x87 within ----*/ 
/*-- the BIOS variable segment ---------- 9-3-3 rrr a 


#define VIO_INFO BYTE ((BYTE far *) MK _FP (0x40, 0x87) ) 


if ( doit ) /* Cursor emulation enabled? */ 
*VIO_INFO BYTE |= 1; /* YES, set bit O */ 
else /* NO, */ 
*VIO INFO BYTE &= 254; /* clear bit 0 */ 


} 


[RRR KEKKEKKREKK KKK KEKE KEKE KKK KEK KKK KKK EEK EKKREKEKKKKKKKKKKKKKKKKKK 


* Function :GETMON ig 
* Task : Determines the type of monitor connected. 
* Input parameters : None 

* Return values : Monitor type 

* MONO = monochrome monitor 

a COLOR= Color monitor 

= EGA = EGA or multisyne monitor 


KKK KKK IEE KKK REE IKKE KKK KERIKERI KEK KK KEE KEE KK KKKEKEKKKEKKKKKKKKKKKKKKKKEK / 


+ + + + + F 


BYTE getmon () 


union REGS regs; /* Processor register for interrupt call */ 
regs.h.ah = 0x12; /* Function number: Determine configuration */ 
regs.h.bl = 0x10; /* Sub-function number */ 
int86(VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 
if ( regs.h.cl == 0x0B } /* Monochrome monitor? */ 

return ( MONO ); /* YES */ 
if ( regs.h.cl == 0x08 ) /* color monitor? */ 

return( COLOR ); /* YES */ 
else /* NO, must be EGA */ 


return( EGA ); 
} 


[BRR RK HRI KIKI IKK KKK KIRK IKK KKK IKI KKK IKKE KEKE KEKE AKEKKEKRKKKAKKKKK KKK 


* Function > SETCUR * 
I Ic se ‘ores seni ni iss: ta i nib Sli eh sa, Sn i se enn ly eh ei ie: a hp i i Ti i's he dm li tl: si i oi sta: i et sm Gr te se spe Se rs kk 
* Task : Sets the screen cursor and the internal x 
x position of the output. x 
* Input parameters : - COLUMN = the cursor column al 
B ¢ - LINE = the cursor line * 
* Return values : None ” 


HHKHKKKHKKKK KKK KKK KEKE KEK KKK KAKI ERK KK KKK KKK KEK KKK KEK KERR KKKKKKKKKKK / 


void setcur(BYTE column, BYTE line) 
{ 


union REGS regs; /* Processor register for interrupt call */ 
regs.h.ah = 2; /* Function number */ 
regs.h.bh = 0; /* Use video page zero */ 
regs.h.dh = vline = line; /* Use global variables for coordinates */ 


regs.h.dl = vcolumn = column; 
int86 (VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 
} 


[RRR KEKKKKKKKKKKEKKE KKK KKK KKK KEKE KEKE KEKE KKEKKKEKEKEKKEKKEKKKKKKKKKER 


* Function > SETCOL * 
Re We ate i cts ets aa i nn ig i ii Sos st cee ete Ino sos seh as Seah st en Se sane as ee eee es lc ell a cl ase i i a a ca i is tl gas en ae ea a a a kk 
* Task : Defines the contents of one of the 16 EGA * 
bs color registers. * 
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* Input parameters : - REGNR = Color register number * 
* - COLOR = Color value (0-15) * 
* Return values : None . 


HIKARI KK RIKI IKK KIRKE KEK KIRK KKK KKK KE KKK KKK KKK KKK KEK KEKE KER KKK KKK / 


void setcol (BYTE regnr, BYTE color) 


{ 


union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = 0x10; /* Function no.: Set color/attribute */ 
regs.h.al = 0; /* Sub-function 0 */ 
regs.h.bl = regnr; /* Set register number */ 
regs h.bh = color £ 63; /* Set color number {( Bits and 7? } */ 
int86(VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 


} 


[ KKK K KKK KKK KEKE KKK KKK KIKI KIKI KEK KIKI KKK IK KIK KKK KK KEK KKKERKEKKEKK KK KKK 


* Function : SETBORDER bal 
I sa ees esas ean ces mes ew ee aes os ss a ass ks wie ees ek ees ea a eco ees ees nS ee aes ee ee a es ee es es a ee ee xk 
* Task : Sets the border color. iad 
* Input parameters: - COLOR = Color value (0-15) *% 
* Return values : None 


RIKKI IKI IK KKK KK IK IKK IKK KIKI KIRKE KRAKAEKAKRKKKKAKK KKK KKK KKK / 


void setborder( BYTE color ) 


{ 


union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = 0x10; /* Function no.: Set color/attribute */ 
regs.h.al = 1; /* Sub-function 1 */ 
regs.h.bh = color & 15; /* Set color value */ 
int86 (VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 


} 


[BERK K KKK KK KKK KKK IKK IKK KKK IK KKK KKK KKK KIKI KEK KEK IEKKKHEKKKKKEKKKKKK KKK KKK 


* Function : SETLINES * 


* Task : Determines the number of lines. - 
* Input parameters: - Sub-function no. for calling function 11H - 
. Ox11 : 8*14 character set * 
‘3 Ox12 : 8*8 character set * 
* 0x14 : 8*16 character set (VGA only) * 
kt 
* 


Return values : None 
KK KR KRIKKKKIK KHIR RE KKK KKK KKK KK KEKE IKKE KKK EEK KKK KKK KAKA KEKE KKK / 


void setlines( BYTE lines ) 


{ 


union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = 0x11; /* Function no.: Character generator */ 
regs.h.al = lines; /* Sub-function no. */ 
regs.h.bl = 0; /* Use character table 0 */ 
int86(VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 


} 


[RRR RRR KKK KKK EK KKK KEK KKK K KEK KKK KR K KKK KEK KEK KEK KEE KK KKK KKK KK KKK KKK K KKK 


* Function IS 2 GA - 
TE Is cnet cmc ces ema Seem ‘in es ces es nace “ers anes eit cs std in nas cies dS es cep "Ss ems cn Ge ae a a ee kk 
* Task : Determines whether an EGA card is installed. * 
* Input parameters: None * 
* Return values TRUE when an EGA or VGA card is installed, and * 
* false in any other case = 


BRK KK KK KK IKK IK IK IK IKK IK III KIKI KKK KKK KKK KKK AKIKKKIEKKKKK KAKA AK KKK K KKK KR / 


BOOL is _ega() 
{ 


union REGS regs; /* Processor register for the interrupt call */ 
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regs.h.ah = 0x12; /* Function number: Determine video configuration */ 

regs.h.bl = 0x10; /* Sub-function number */ 
int86 (VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 
if ( regs.h.bl != 0x10 ) /* Is it an EGA or VGA card? */ 
/*-- Set pointer in video RAM for attached monitor ---------------- */ 
vptr = (VP) MK FP( (mono = regs.h.bh) ? Oxb000 : Oxb800, 0); 

return( regs.h.bl != 0x10 ); /* BL != 0x10 --> EGA or VGA */ 


} 


[RK KKKIEK EKER EKER KAKI KKK KEKE KEK EK KKK KKEKKKEKKEEKKKKK KKK KKK 


* Function >: IS VGA * 
* Task : Determines whether a VGA card is installed. 

* Input parameters: None 

* Return values : TRUE when a VGA card is installed; 

* FALSE in any other case. 

* Info This function should be called before the 

- is_ega function, because the parameters in the 
* 

* 

* 

* 

* 


is ega function also apply to VGA cards (i.e., 
TRUE will be returned to is ega for a VGA card. 


Call is vga first in your own applications, 


then call is ega. 
HK IKK IKK KKH IK KKK IK KKK KKK KKK KKK IKK KKK KEK KKK KKK KKK EKK KEK KEKE EKKKEKEEEK / 


+ + + + + + + + HF HF 


BOOL is_vga() 
{ 


union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = Oxl1A; /* Function no.: Determine video configuration */ 
regs.h.al = 0x00; /* Sub-function number */ 
int86(VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 
if ( regs.h.al == Oxl1A && ( regs.h.bl==7 |{ regs.h.bl==8 ) } 

{ /* VGA card connected to VGA monitor? */ 

mono = FALSE; 

vptr = (VP) MK _FP( Oxb800, 0 ); /* Set pointer in video RAM */ 


return TRUE; 


} 
return FALSE; /* No VGA card installed */ 


} 


[RRR RRERK KKK IKKE K KKK IKK IK KEKE KKEKKEKKKKKKKKEAKKKEKEKKKKK KAKA KKK KKK KKK KKK 


* Function >: PRINTAT mn 
SE Se a a a a a En a a ee Ce en LE Ea ee kk 
* Task : Displays a string on the screen. - 
x tk 
* Input parameters: - COLUMN = Display column. * 
* - LINE = Display line. ba 
* - CHCOLOR = Character attribute. x 
s - STRING = Pointer to string. * 
* Return values : None * 
* Information : - This function does not recognize format specs * 
* aS supplied by PRINTF. * 
* - When the function reaches the end of the * 
* * 


screen, the screen will not scroll up. 
HHKEKKEKKEKKEKREKEK EKER KKK KKK KK KERIKERI KRK KEKE KKK KEKRKEEK EKER KERR KEKEKEKEKKKKKKK / 


void printat (BYTE column, BYTE line, BYTE chcolor, char * string) 


{ 


register VP lptr; /* Floating pointer to video RAM */ 
register BYTE i; /* points to the number of characters */ 
unsigned newofs; /* Computes new coordinates */ 
lptr = VPOS(column, line); /* Set pointer in video RAM */ 
for (i=0 ; *string ; ++lptr, ++i) /* execute string */ 
{ 
lptr->ascii code = * (string+t+); /* Character in video RAM */ 
lptr->attribute = chcolor; /* Set character attribute */ 


} 
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/*-- Compute new cursor coordinates ----~---9 nen rr rrr i A 


vcolumn = (newofs = 
vline = newofs / 80; 


} 


(({unsigned) line * 80 + column + i)) % 80; 


J RII RI IIR IK II KI TIT IK IKE IKI II KIKI IK IKK KI IKK IKK KKK KIKI KK KEE KEKE KKK KK 


* Function >: PRINTFAT . 
i nmi ag a es a a se nn ean es as wa as ke es aaa a je hn asa i see ie sls pp iin ces cae nel al es eee os x* 
* Task : Displays a string on the screen (like PRINTF), * 
rn writing the string directly to video RAM. * 
* Input parameters: - COLUMN = Display column. . 
* - LINE = Display line. * 
* CHCOLOR= Character coior. . 
* - STRING = Pointer to the string. id 
ss — see = Additional arguments as needed. - 
* Return values : None . 
* Information : - When the end of the screen is reached, the x 
* screen will not scroll up. x 
i : - string can use the normal format specifier * 
* group as used with PRINTF. . 
k 


FR II TOK I IIR HII HK IKK IH KK IKK KIKI AKI KI IK IK RII KAA K EKA AKA KKK KKK KKK KEK / 


void printfat (BYTE column, BYTE line, BYTE chcolor, char * string,...) 


{ 
va_list parameter; /* Take parameter list for VA_... Macros from */ 
char output [255]; /* the formatted, displayed string */ 


va_start (parameter, string);/* Get parameters in PARAMETER variable */ 
vsprintf (output, string, parameter) ; /* Convert string */ 
printat (column, line, chcolor, output); /* Display string */ 
} 


[RRR HER KAKKKRKRKK KKK KE EK KEK KEK KIRK KEK KKK KEK KEKE KEK KIKKAKKKKKKKKKK KKK 


* Function >: BLINKING x 
Choe Cee ee ee eee eee Le ee ae ees ee ee ee eee ee ee eee eee kk 
* Task : Defines the meaning of bit 7 of the attribute * 
* byte of a character in text mode. * 
* Input parameters: DOBLINK = TRUE : Blink. * 
¥ FALSE : Light background color. * 
* Return values : none * 


He AK RAK HHI HICK EI KK II RK IKK IKK KKK IKK IK KI KIKI KKK KKK KEK KKK KEKE KKKKKE KKK / 


void blinking( BOOL doblink ) 
{ 


union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = 0x10; /* Function no.: Set color/attribute */ 
regs.h.al = 0x3; /* Sub-function number */ 
regs.h.bl = doblink ? 1 : 0; /* BL = 1 : blinking */ 
int86(VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 


} 


[RAKHI KKK KKK KKK KKK KKK KKK KEK KIRK IK KKK KEKE EKER KKK KEK KEKKKKEKKKKAKKE 


* Function > CLS * 
FOIE is toh es Gi cen ies cas ee ce isn ins Gn ia seh ances sass som‘ som nines semis sn cma car is ns sn ams sic ests cms ein’ Sa msn is ins cass i ‘rei aia ta i Si ena mm Kk 
* Task : Clears the screen and resets the video mode. * 
* This reset includes the palette registers, as = 
x well as the character set in use. * 
* Input parameters: none = 
* Return values : none * 


HAKKAR KKK KIK KKK KEK KEKE KK KEKE KEK KKK KKK KKK IKKE RK KKK EKKKAEKKKEKEKKKK / 


void cls() 
{ 
union REGS regs; /* Processor register for the interrupt call */ 
regs.h.ah = 0x0; /* Function no.: Set video mode */ 
regs.h.al = ( mono ) ? 7: 3; /* 80x25-char text mode */ 
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int86 (VIDEO INT, &regs, &regs); /* Call BIOS video interrupt */ 
} 


[RRR KIKI III IID RIKKI IKI AKER AKER KEKE KEKE KKK KHAKKKKEK 


* Function >:NOKEY * 
Ch oak Se eee eee eee Ce eae ee ee eee ae ee ee eee eee ee See ee ee eee eo eee kk 
* Task : Tests for a depressed key. ~ 
* Input parameters: none sd 
* Return values : TRUE if a key is depressed, otherwise x 
* FALSE. x 


RIKKI KKK KEK AIK KIKI AEH IKK IK IKKE KKK EEA EKAEKKEEKERKKKKKKKAK KKK KKK KKKKK / 
BOOL nokey () 


{ 


#ifdef | TURBOC __ /* Using TURBO C to compile? */ 
return( bioskey( 1) == 0 ); /* YES, read keyboard from BIOS */ 
#else /* Using Microsoft C to compile... */ 
return( bios keybrd( KEYBRD READY ) == 0 }; /* Read from BIOS */ 
#endif 
} 
[RARER IK KIKI KIKI KKK IKARIA KKK KKK HIKE KKK ARE KKK KREKEKKKEKEKKKKKKKKKK 
* Function _ > EGAVGA - 
GoW re ce ee te ee eae ee ae ee ee ee ee ee ce or sa em ee eee ee aa ae ne ee ee ee a eet Oe ee ee a a ee em ee a Oe a ee eS ee nO oe ee ea ees eee xk 
* Task : Demonstrates the application of EGA/VGA BIOS - 
* functions z 
* Input parameters: VGA : TRUE when working with VGA card . 
* FALSE in any other case * 
* Return values : none . 


KKK KIKI KIKI KIKI IIHR ERIKA III HAKKAR KKK EE KAKEKKEKEEKEKKEKEKEKKEK / 
void egavga( BOOL VGA ) 
Static BYTE font[120][14] = { /* Character definition for logo */ 


{ 0, 0,255, 62, 28, 28, 28, 28, 28, 28, 28, 28, 28, 31}, /* T */ 
0/252, 7 4, . dy ay he 2p. 4G Ay cay - F252). /* 


© 
- 


{ h 

{ 0, 0, 0, 0,129,195,195,199,199, 206,206,142, 14, 14}, /* ea */ 
{ 0, 0, 62,193,128,128, 0, 0, 0, 0, O, O, O, O}, /* s */ 
{ 0, 0, 16,144,112, 48, 48, 16, 16, 0, 0, O, O, O}, /* e */ 
{ 0). .0,.. Op 70% 0, Os 105 0, 0; 0, 0): Ox 0% “OT, /* */ 
[ O,. 0,7 -.3, °0,. 2056 0, Oy 20, “Op Oy Oe “0, 0, OF, /* 1 */ 
{ 0, 0,254, 248,112,112,112,112,112,112,112,112,112,112}, eee Oa | 
{ 0, 0, 0, O, O, 0, 0, 0, 0,252, 61, 30, 30, 28}, /* n */ 
{ 0, 0, 0, 0, 0, 0, O, O, 0,248, 6, 7, 3, 3h, /* e@ */ 
{ 0, 0, 0, 0, O, 0, O, O, OO, 7, O, O, 0,128}, /* s */ 
{ 0, 0, 32, 96,224, 224,224,224, 224, 254,224, 224,224,224}, heal a] 
{ 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 6, 12, 28, 24}, se co */ 
{ 0, 0, 0, 0, O, 0, O, O, 0,240, 28, 6, 7, 7}, /* o */ 
{ 0, 0, 0, 0, O, O, O, O, O, 63, 15, 7, 7, Th, /* n */ 
{ 0, 0, 0, 0, O, 0, O, O, O, 30, 39, 71,135,128}, /* t */ 
{ 0, 0, 0, O, O, O, O, O, 0,126, 30, 15, 15, 14}, /* a */ 
{ 0, 0, 0, 0, O, 0, O, O, 0,124,131, 3, 1, 1}, /* i */ 
{ 0, 0, 0, 0, O, O, O, O, O, O, 0,129,131,195}, /* n */ 
{ 0, 0, 0, 0, 0, 0, O, O, O, O, 62,193,128, 0}, /*  */ 
£9 09:05. 07 Op 2055 Os 202: 0, Oy 0; -0, 192,294, 234), /* t */ 
{ 0, 0,248,120, 56, 56, 56, 56, 56, 56, 56, 56, 56, 56}, [®t *7 
{ 0, 0, 0, 0, 0, 0, O, O, O, 31, 48, 48, 48, 48}, /* @ */ 
{Op Op: 20, 0p -O,...0, (0, “0, “07196, 52,-125..44° 4}, /* */ 
0p “Op: 0,05: Op Oye 20%. Oy. 0, 0, 0, Oy. 0, “OF; /* b */ 
£0, Op. 20, 0, 0). 0, 0," 0; 20;.. 0, .-0,...°0, -0,.. 0}, /e i */ 
{ 0, 0, O, O, O, O, O, O, O, O, O, O, OO, OQ}, {2° -*/ 
Oe. 09° Oe. 05, Oy. “Oy. 0, O,. “0,2. 205. 0,- 0, 10,:. “O}; [x */ 
{ 0, 0, O, O, O, O, O, O, O, O, O, O, O, ODO}, /* p */ 
{ Oy. <0; 0, 0; 0% 0; 0, 0, 0, 0, 0; 0,. 0% OF}, /* a */ 
{ 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, O, O}, | aia a 
{ 0, 0, 0, O, O, O, O, O, 0,128, 0, O, O, O}, gi al 
{ 14, 14, 14, 7, 7, 3, 3, 1, 0, 0, 0, 0, 0, O}, /t e */ 
{ 0, 0, 0O, O, O, O0O,128,128,193, 62, 0, O, O, O}, | ule tae 
{ 0, 0, 0, 0, 16, 16, 32, 64,128, 0, 0, 0, O, O}, /* n */ 
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{ “0; 0;- 0;- 0;- 0, 0, 0). 0, G7 0; 0} 0,- 0,- 0}, /* 5 */ 
{ 0, 0, 0, 0, 0, 0, 0, 0, O, 3, 0, O, O, O}, /*  / 
{112,112,112,112,112,112,112,112, 248,254, 0, 0, 0, O}, /* £ */ 
{ 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, 0, O}, /* 0 */ 
{ 3, 3, 3, 3, 3, 3, 3, 3, 7,159, 0, 0, O, O}, /* xr */ 
(128,128, 128,128,128,128,128,128,192,240, 0, 0, 0, O}, fe 4/ 
{224, 224,224, 224,224,224, 96,112, 49, 30, 0, 0, 0, O}, /*t */ 
{ 56, 63, 56, 56, 56, 24, 92, 76,134, 1, 0, 0, 0, O}, /* h */ 
{ 7,255, 0, 0, 0, 0, 1, 2, 12,240, 0, 0, 0, O}, /* e@ */ 
te 8 Te Wy. De Te TS 99563, 05. 0, 0; 0), /*  */ 
{ 0, 0, 0, 0, 0, 0, 0, 0,128,224, 0, 0, 0, O}, /* co */ 
{ 14, 14, 14, 14, 14, 14, 14, 14, 31,127, 0, 0, 0, 9}, /*h */ 
{ 1, 1, 1, 1, 1, 1, 1, 1, 3,207, 0, O, O, O}, [* ay th 
(192,192, 192, 193,193,195, 195,193,225,248, 0, 0, 0, O}, /* xr */ 
{ 0, 7,120,192,192,128,128,192,195,124, 0, 0, 0, O}, /* a */ 
{224, 224, 224, 224,224, 224, 224,240,112, 29, 0, 0, 0, O}, /* co */ 
{ 56, 56, 56, 56, 56, 56, 56, 56,124,255, 0, 0, 0, O}, /* t */ 
{ 31, 31, 31, 0, 0, 64, 96, 96,112, 71, 0, 0, 0, O}, /* e@ */ 
{ 0,224,248,252, 28,.12, 4, 12, 24,224, 0, 0, 0, O}, /* xv */ 
{ 0, 0, 0, 0, 0, 0, O, O, 0, O, O, O, O, O}, /* s */ 
{ "0, 0, 6, -0, 0, 0, 0, 0,.°0, -0, 0, 0, 0, 6}, [ef 
(0, 0, 0. 0, . 10, “02-20, 10.:. “05. +0; 0. 0, 0,. “Oh; /* on */ 
{ ©, 205. 0; O.. ©. O 20, <0, 0; °0,. 0;---0,.. 0; <0}, /tet/ 
i Oy. 0p 505: 105.. 90; Oy “O> 0;.. 0,. 0; “0, O,.~0,2 <0}, /* e */ 
i 0 (Os. Oy: 0 Os 90, 10.0 Oe. “Oy. -O,. 04-205". 0, ONY /* da */ 
{ 0, 0,252, 60, 30, 30, 30, 23, 23, 23, 19, 19, 19, 17}, /* e */ 
{ 0, 0, 0, 0, 0, 0, O, 1, 1, 1,130,130,130,196}, /* a */ 
{ 0, 0,126,120,240, 240, 240,112,112,112,112,112,112,112}, je */ 
{ 0, 0, 28, 28, 28, 0, 0, 0, 0,252, 60, 28, 28, 28}, Je i t/ 
{ 0, 0, 0, 0, O, O, 0, O, O, 1, 6, 12, 28, 24}, /* on */ 
i 0,- 0; 0,04. 0... 0,-.20,. 0, 02240, 22,. 2, 7,> “T), fe + 
fe 30 O60 684-155. I. De. Te, “Da. Dee ee Tee To, Te OWN /*t */ 
{ 0, 0, 0, 0, O, O, 0, O, 0, 62, 65,129,128, 0}, /*h */ 
{ 0, 0, 0, 0, 0, 0, O, O, O, 0,128,192,192,224}, /* e */ 
{ 0, 0, 0, 0, 0, O, O, O, O, 63, 64,224,224, 224}, je #/ 
{ 0, 0, 0, 0, 0, 0, 0, 0, O, 0,192, 96,112,112}, se 1 */ 
{ 0, 0, 0, 0, O, O, 0, O, O, 7, 24, 48,112, 96}, /* 0 */ 
{ 0, 0, 0, 0, 0, O, O, O, 0,192,112, 24, 28, 28}, /* g */ 
{ 0, 0,252, 60, 28, 28, 28, 28, 28, 28, 28, 28, 28, 28}, /* 0 */ 
£20, 205. Gia “0,7. <0, 0: 0; 0, 0, 0; 05 <0; *0,--O}, fe 
i 05> Op Oe. 20,5 05°. 20. 10, Oy. 0). 20,- 20;- 10) 0, OF, ft a */ 
{ 0, 0, 63, 56, 48, 48, 32, 32, 32, 0, 0, O, O, O}, Jet */ 
{) “O,.. 20,255, 172,412, 112,112, 112,122,919, 712,11 2,112, 1124, /* 
{. OQ, 0,225, 295, -97,..32,. 32,. 32, 32. 15, 3, Ue. 1, At, /* t */ 
{ 0, 0,192,192,192, 0, 0, 0, 0,192,193,195,195,195}, /*h */ 
{ 0, 0, 0, 0, 0, O, O, O, 0,252, 3, O, O, O}, /* e */ 
fk 0% 0, 0; 0%. O,..-0,- <0,.. 0: “0,. 64,65, 195, 71. 70}, Jt */ 
fp 0,- 20¢: O°. 205: 20;..0, .--0,-. 40,424,199. “10, 1. 14, /* co */ 
{! 90,- 0, 5). 3. Ty: Ay: “Ae. Ay Dye | ae 1 129,, 193,193, /te */ 
{ 0, 0,192,192,192,192,192,192,192, 207,208, 224,224,192}, /* n */ 
{ 0, 0, 0, O, 0, O, O, 0, 0,128, 96,112, 48, 56}, set */ 
{ 0, 0, 0, 0, 0, O, O, O, O, 3, 12, 24, 56, 48}, /* e */ 
{ 0, 0, 0, 0, 0, 0, O, O, 0,224, 56, 12, 14, 14}, /* x */ 
( Ge 305° Oe 205. 05. °0,. “0; °0,: 0,126, -30;: 14), 25, 15}, Je */ 
{ 'O), GO, 0,-0.0, O-. “0;. 0... 0.960, 78,147, 14,- “Ot; /* 0 */ 


ba) 


re) 
a 
{ 17, 17, 16, 16, 16, 16, 16, 16, 48,254, 0 0}, GR L RF 


= 
~ 
~ 


0, O 

{196,196, 232, 232,232,112,112, 80, 32, 35, 0, 0, O, O}, Jef 
{112,012,412,419 719,119,112 9,119;- 948,954... 0,. -0,< 10, 0}; /* t */ 
{ 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, 0, O}, /*h */ 
{ 56, 56, 56, 56, 56, 24, 28, 12, 6,129, 0, 0, 0, O}, /*e*/ 
{- 95. 0O,. 0; “0, 20,. Ox. “1. - 2-12 940,..-.0,- 0; 05. OF; /* +f 
3% ee Fs Ne. Fs. Ds. Dp AS OS. 0%, Oy 0, OF, /* 5 */ 
{ 0; 20. 02 0,: Os 20, .0.:.*0; 229,231. -0,- -0,;--0,. 0}, /* co */ 
{224, 224, 224, 224,224, 225, 225, 224,240,252, 0, 0, 0, O}, /* xo t/ 
{ 0, 3, 60,224,224,192,192,224,225, 62, 0, 0, 0, O}, /te*/ 
{112,240,112,112,112,112,112,120,184, 14, 0, 0, 0, O}, /te*/ 
{224,255, 224,224,224, 96,112, 48, 24, 7, 0, 0, 0, O}, /* n */ 
{ 28,252, 0, 0, 0, O, 4, 8, 48,192, 0, 0, 0, O}, je */ 
{ 28, 28, 28, 28, 28, 28, 28, 28, 62,255, 0, 0, 0, O}, 

{°-0,. 0,. 05. 0, -0,. %0;..-0;,. O;-. “0,128; <0, “0,. 0, Ot; 
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{ 0, 0, 0, 0, O, O, O, O, O, O, O, O, O, O}, 

{ 0, 0, 0, 0, O, O, O, O, O, 3, O, O, O, O}, 

{112,112,112,112,112,112,112,112,248,254, 0, 0, O, O}, 

{ 1, 1, 1, 1, 1, 1, 1, 1, 3, 15, 0, O, O, O}, 

{193,193,192,192,192,194,195,195, 227,250, 0, 0, O, OO}, 

{240,254,255, 15, 1, 0, 0O, 0,129,126, 0, O, O, O}, 

{ 14, 14,142, 206,206,198, 71,195,129, 0, 0, O, O, O}, 

{ 2, 6, 0, O, ©6, 0, 0, 0,131,124, 0, ©, 0, O}, 

{193,: i, 4d, Jd, 1,1, 65,129, 3,18, °0; 0, ~0; 9}, 

{192,192,192,192,192,192,192,192,224,249, 0, 0, O, O}, 

{ 56, 56, 56, 56, 56, 56, 56, 56,124,255, 0, O, O, OQ}, 

{112,127,112,112,112, 48, 56, 24, 12, 3, 0, 0, O, OQ}, 

{ 14,254, 0, 0, O, O, 2, 4, 24,224, O, O, O, OQ}, 

{ 14, 14, 14, 14, 14, 14, 14, 14, 31,127, 0, 0, O, OQ}, 

{; 0, Of; O, 0, 0, 0, 0, -0,. -0,;192,.. 0, -0,. .0,. 0} 
}; A 
union REGS regs; /* Processor register for the interrupt call */ 
unsigned i, j, k; /* Loop counter */ 
double delay; /* Loop counter for PAUSE */ 
/*-- Prepare SCY@@N --- 9-9-9 rn rrr rn ey. 
cls()}; /* Clears screen */ 
blinking( FALSE ); /* Light background color instead of blinking */ 
setcur(0, 0}; /* Move cursor to upper left corner */ 
/*-- Install EGA and VGA hardcopy routine -------------------------- «/ 
regs.h.ah = 0x12; /* Function no.: Alternate Select */ 
regs.h.bl = 0x20; /* Sub-funct. 0x20 = Install hardcopy routine */ 
int86(VIDEO_INT, &regs, &regs); /* Call BIOS video interrupt */ 
if ( VGA ) /* Check for compatibility */ 

{ /* and check custom characters */ 

regs.h.ah = 0x12; /* VGA card in 350-line mode */ 

regs.h.bl = 0x30; /* Toggle EGA card */ 

regs.h.al = 1; 

int86(VIDEO_INT, &regs, &regs); /* Call BIOS video interrupt */ 

setlines({ 0Oxl1l ); /* Enable 8x14 character set */ 


} 


chardef (128, 0, 14, 120, (BYTE far *) font); /* Define characters */ 


for (i=0; 1<250; ++i) /* Execute loop 250 times */ 
{ /* Write color blocks to video RAM */ 
printfat (GETCS(), GETCZ(), ((i % 14) + 1) << 4, " ah 
printfat (GETCS(), GETCZ(), 0, "™ ") 9 

} 

for (i1=10;7; i<16; ++1) /* Allocate space for logo */ 
printat (22, i, 0, " a a 

for (k=128, i=O; i<4; ++i) /* The logo consists of ASCII */ 
{ /* characters 128-248 */ 


for (j=0; 4<30; ++3) 
printfat (j+24, i+11, 15, "tc", k++); 

} 
printat(1, 1, 15, “The most important characters are"); 
printat(1, 2, 15, “still present despite the logo! "); 
printat(1, 3, 15, " a 
printat(1, 4, IN“ #S$E' () *+—./01234567893: 5<=>2@ ");7 
printat (1, 5,15, ABCDEFGHIJKLMNOPQRSTUVXXYZ[\\]*_ “)7 
printat(l, 6, “abcdefghijklmnopaqrstuvxyz{|}~ "); 


- 
a 
~ 


pa 
ow 
= 


printat (33, 21, 15, ™ ")7 
printat (33, 22, 15, " Press any key to end the program. “V2 
printat (33, 23, 15, " go 7 
setcur( 34, 22); 

/*-- Change colors in the color blocks -----------------~----------- Fd 
1 = 0; /* Starting value for color register */ 
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while ( nokey() ) /* Repeat until the user presses a key */ 


{ 
for ( delay=0.0; delay < PAUSE; ++delay ) 


’ 


++i; /* Increment color value for the first register */ 
for (j=l; 4j<15; ++34) /* Go through registers 1 to 14 */ 

{ 
setcol(j, i+j & 63); /* Write color value in register */ 
if ( !nokey() ) /* Key pressed? */ 
break; /* YES --> Stop loop before restarting */ 

} 

} 

if ( VGA ) /* Go into 400 line mode */ 
{ /* Enable VGA card ay 


regs.h.ah = 0x12; 
regs.h.bl = 0x30; 
regs.h.al = 2; 


int86 (VIDEO _ INT, &regs, &regs); /* Call BIOS video interrupt */ 
setlines( 0x14 ); /* Enable 8*16 character set */ 
} 

cls(); /* Clear screen */ 


} 


[RRR HARIKA KIKI KI KIKI KHATRI IKKE I KK IKI KKK IKK IKI KAKA KKK KKKKKK KA / 


/** MAIN PROGRAM ee / 
[RRR IKI IK KIKI KIKI IKI KIKI IKK KK IKK III IKI KK IKKE IKKE KEK IKK KIER KK KKK KEKE / 


void main() 
{ 


if ( is_vga() ) /* Is there a VGA card installed? */ 
egavga( TRUE ); /* YES */ 
else /* No VGA installed - go on */ 
{ 
if ( is_ega() ) /* Is there an EGA card installed? */ 
/* YES */ 
if ( getmon() == EGA ) /* Is there an EGA monitor connected? */ 
egavga( FALSE ); /* YES, start demo */ 
else 
{ /* wrong monitor */ 
printf ("This program functions only with an\n"); 
printf ("EGA monitor. \n"); 
} 
} 
else /* If no EGA or VGA card connected */ 


printf( "ATTENTION! There is neither an EGA nor a " 
“ VGA card installed.\n" ); 


Assembler listing; EGAVGACA.ASM 


HRA E KEKE RRR IKK KKK KKK KEKE KKK KKK EK KKK KKK KEKE KEKE KR KKKEKEKKK KKK KK © 
* 


: 
; EGAVGACA *; 
bai coe en ew am ee oe ee ws ee oe em om een es oe ea ces om en es ce er es oe es ow a ee OO eee ee ee oe ee oe ee oe ee oe ee om ee en xs 
ro Task : Generates a functions for custom designing * 
.* characters. ba 
iad oe cam a ene ams ee oem es Srv cet comm eb ceee nD wee OS Ce nD MED San GEES OD WD GENE ERD GD Es MED ND CD Mes GED GED Uw ED One OD CED ene EET en SUD ame US Oe een Ms WOU EE co OS CE eS GED OD Gam nn cD ee ce aN eS EID En co nS 
reg Author : MICHAEL TISCHER x 
s* Developed on : 09/25/1988 ir 
on Last update : 06/07/1988 Rs 
es SF Oe cen a eee a OD HD ED SED OT GED GED SEND GD EE AD SEND SUED GP GED SOS GD GUD GNP IED SOND GED WP ED ep GND GIGD GERD ENP SEND. SEND EDP ED OOD MED EN MD END GD ED I? GRD GED cs END EME HUY GUND GOED GOH SEND GMP SEND GD ND-GRED cv EE GD ND GED ard 
7* Assembly : MASM EGAVGACA; a) 
hg .-- Link with a C program whose memory model *; 
ries has been set to SMALL *; 
FEAR ERE KERR REE KER KEK RE EK KEKE HERE KEKE KEK KEKE EKKEKKKKEKKEKKKEKKKEK © 


c 
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IGROUP group text sAddition to program segment 
DGROUP group const, bss, data ;Addition to data segment 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public 'CONST';This segment includes all read-only 
CONST ends ;constants 


BSS segment word public 'BSS' ;This segment includes all un-initial- 
_BSS ends sized static variables 


_DATA segment word public 'DATA' ;This segment includes all initialized 
7Qlobal and static variables 
_DATA ends 


_TEXT segment byte public ‘CODE’ ;Program segment 


public _chardef 

Sioa eeer ea oa ea eee eet ewe none eee ee eee eee 
7~~ CHARDEF: Defines the appearance of a character --------------------- 
7-- Call from C : void chardef( BYTE ascii, BYTE table, BYTE lines, 

ae -— BYTE amount, BYTE far * buf); 

7-- Return value: none 


_Chardef proc near 


sframe struc 7;Stack access structure 
bptr dw ? 7Take BP 
ret_adr dw ? ;Return address of calling program 
ascii dw ? ;ASCII code of character 
table dw ? ;Number of character table 
lines dw ? ;Character matrix height 
amount dw ? ;Number of characters to be defined 
bufptr dd ? 7FAR pointer to buffer 
sframe ends yEnd of structure 
frame equ [ bp - bptr ] ;Addresses elements of structure 
push bp 7Push BP onto stack 
mov bp,sp ;Transfer SP to BP 
mov ax,1100h 7Function no. 11H, sub-funct. 0 


mov bh,byte ptr frame.lines ;Character matrix height 

mov bl,byte ptr frame.table ;Number of character table 
mov cl,byte ptr frame.amount zNumber of characters 

xor ch,ch 

mov dl,byte ptr frame.ascii ;Get ASCII code of character 


xor dh,dh 

les bp, frame.bufptr ;Buffer address to ES:BP 

int 10h ;Call EGA BIOS video interrupt 
pop bp 7Pop BP off of stack 

ret 7Return to C program 


_chardef endp 


_text ends 7End of code segment 
end 7;End of program 
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7.5 Determining System Configuration using BIOS 


Some programs (e.g., copy programs) must determine how many disk drives are 
connected to the PC, or how much RAM exists on the main circuit board or 
motherboard. This information can be obtained with the help of BIOS interrupt 
11H. 


The content of individual registers is not important during the call of this 
interrupt, since neither the function number nor another argument must be passed. 


The configuration, which is determined during the system booting process, is 
returned in the AX register. The individual bits of this register contain the 
following information: 


Bit (s) 
Equal to 1 if 1 or more disk drives are available 
Pe UNSC ge | 


Oe casts 
RAM memory on the main circuit board 
[nem 612 U | ne ee ee 
10 = 48K 

aes i 

465 
1 


O02: 80*25 characters - color card 
03: 80*25 characters - mono card 


0 1 disk drive 


r1OTO 


1 = 2 disk drives 
0 = 3 disk drives 


bo 


Indicates number of disk drives in system if bit O is 
i 


1 

ars 

ead 

4a 5 | 

eee 

aan 

ar 

Ses 

le oeseenced 

ana) 

pease 

es ern 
8s Equal _to 0 when DMA chip is available 

4 


indicates the number of printers 
While this bit assignment is the same for the PC and the XT, it differs from the 


configuration word returned by the AT. To interpret the content of the AX register 
correctly, you must know the model of the computer being tested. 
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| | Equal to 1 if 1 or more disk drives are available _| 


-03 

-05 Video mode during system boot 
-07 

at rat 


00: Unused 
O01: 40*25 characters — color card 


02: 80*25 characters - color card 
03: 80*25 characters - mono card 


Indicates number of disk drives in system if bit 0 is 
1 


00 = 1 disk drive 
O01 = 2 disk drives | 


10 = 3 disk drives 


= 4 disk drives __ 


Unused 


(09-11 Number of RS-232 cards attached | 
U 


IO IToO 


— 


00 
oan 
Poe 
eee 
| 
ees 
in 
eae 
eee) 
os 
09 


1213 vs URUSed an ns en ee 
14-15 indicates the number of printers 


Do not use this function to sense the current video mode, since it only indicates 
the video mode switched on during system booting. Function 15H of interrupt 
10H provides the number of the current video mode. 
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Determining Available RAM using the BIOS 


While interrupt 11H only returns the amount of RAM on the main circuit board, 
interrupt 12H obtains the amount of RAM available in the entire system. The 
total amount of RAM from the main circuit board and any memory expansion 
cards are returned. The DIP switch settings on the memory boards determine the 
amount of memory reported available on the PC and XT. The interrupt routines 
derive the amount of RAM on an AT by reading one of the 64 memory locations 
on the battery powered realtime clock. 


Memory limits 


This method determines RAM below the 1 megabyte limit only. The 8088's 
addressing capability limits memory to 1 megabyte, so the PC and XT can report 
on the entire memory available. The AT's 80286 processor can manage up to 16 
megabytes of memory. However, interrupt 12H cannot report on any RAM beyond 
1 megabyte. 


The memory size returned is passed in the AX register as a multiple of 1K (1024 
bytes, not 1000 bytes). For example, if the AX register contains 256, you have 
256K of RAM available in your PC. 


Demonstration programs 


The three program listings in this section are practical examples of the interrupts 
described in the preceding section. The three programs, which were written in 
BASIC, Pascal and C, are identical in their basic design. 


They test the model identification byte in memory location FO0O:FFFE to 
determine whether the computer is a PC, XT or AT. The equipment designation 
appears on the screen. This model identification acts as the basis for identifying the 
processor type as well. The program assumes that an AT has an 80286 and all 
other PCs have an 8088 processor. During the next step in the programs, interrupt 
12H determines the amount of RAM on the circuit board and returns that amount. 
As mentioned above, the AT can have additional RAM memory beyond the 1 
megabyte limit. Each program tests for that additional RAM if the equipment 
designation indicates an AT. The programs use function 88H of interrupt 15H (see 
Appendix B for detailed documentation). For the moment, all you need to know is 
that this function passes the amount, in multiples of 1K, of RAM above the 1 
megabyte limit to the AX register. 


After displaying this information, interrupt 11H determines the equipment 
configuration. The last task of the program consists of filtering out the 
information encoded in the bits of the configuration word and displaying it on the 
screen. 


To keep the program from becoming too long, the programs limit themselves to 
the identical bits of the configuration words in the PC, XT and AT. For example, 
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BASIC 
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the programs skip the AT information concerning the availability of a math 
coprocessor. 


You may want to rewrite this program so that it displays all the information 
contained in the configuration word according to computer type. 


The comments in each listing should answer any questions you may have about 
program flow. 


listing: CONFIGB.BAS 


100 CHK KKKKKAKKKEEKKAKIKKEKEKAKEKEREKEKRKKKREKKEKKKKAKERKKEEREEKEKKKKKEKKKKKK 


110 '* CONFIGB ne 
990) Ui Wewae ete aa eee ae ee eae eS aaa ee ee eae eee eee ee * 
130 '* Task : Displays the Configuration of the PC aA 
140 ‘'* iis 
150 '* Author : MICHAEL TISCHER xs 
160 '* developed on : 7.20.87 mS 
170 ‘* last Update : 9.21.87 = 
180 Pee ec eee eeeeeeceeee cee eee eee SSS See eee eee CASS ECL ES ERS SE eee REE SS ee ee 


190 ! 

200'CLS : KEY OFF 

210 PRINT“WARNING: This program should only be started if the GWBASIC " 
220 PRINT“was started from the DOS level with <GWBASIC /m:60000>." 

230 PRINT : PRINT"If this was not the case, then input <s> for Stop." 
240 PRINT“Else press any key ..."37 

250 AS = INKEYS : IF AS = "Ss" THEN END 

260 IF AS = ““ THEN 250 


270 GOSUB 60000 ‘Install Function for interrupt Call 

280 CLS ‘Clear Screen 

290 DEF SEG = &HFOO00 *BIOS-Segment 

300 PRINT “CONFIG (c) 1987 by Michael Tischer" 

310 PRINT 

320 PRINT “Configuration of Your PC" 

330 PRINT “------------—---- = nn rn nn nr rn = 


340 PRINT "PC-Type “; ‘determine PC type 


350 IF PEEK(&HFFFE) = &HFF THEN PRINT “PC" : GOTO 390 

360 IF PEEK(&HFFFE) = &HFE THEN PRINT "XT" : GOTO 390 

370 IF PEEK(&HFFFE) = &HFC THEN PRINT “AT“ : GOTO 390 

380 PRINT “unknown" 

390 PRINT “Processor : 80"; 

400 IF PEEK(&HFFFE) = &HFC THEN PRINT “286" ELSE PRINT "88" 

410 INR% = &H12 'BIOS-interrupt reads RAM size 
420 DEF SEG ‘Set BASIC-Segment again 


430 CALL IA(INR%, RAMHI$%, RAMLO%, 2%, 2%, 2%, 2%, 2%, 2%, ZB, 2%, 2%, Z%) 
440 PRINT “RAM-Memory (Main Circuit Board) :"?7RAMHI%*256+RAMLO$%; “KB" 


450 DEF SEG = &HFO00 *BIOS-—Segment 

460 IF PEEK(&HFFFE) <> &HFC THEN 520 ‘branch if not AT 

470 DEF SEG ‘set BASIC-Segment again 

480 INR%& = &H15 ‘Call Cassette interrupt 

490 RAMHI% = &H88 ‘Function for reading of HI-RAM size 

500 CALL IA(INR%, RAMHI%, RAMLO%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, ZB, 2%, 2%) 

510 PRINT “Additional RAM-Memory 2"; RAMHI%* 256+RAMLO%; "KB beyond 1 MB" 
520 DEF SEG ‘Set BASIC-Segment again 

525 INR& = &H11 ‘BIOS-interrupt reads Configuration 

530 CALL IA(INR%, CONFHI%, CONFLO$%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, ZS) 

540 PRINT “Video mode after Start ame 3 

550 IF CONFLO% AND 48 = O THEN PRINT"undefined" : GOTO 590 

560 IF CONFLO% AND 48 = 16 THEN PRINT"40*25 Character, Color-Card" : GOTO 590 
570 IF CONFLO% AND 48 = 32 THEN PRINT"80*25 Character, Color Card" : GOTO 590 


580 PRINT"80*25 Character, Mono-Card" 


590 PRINT"Disk drives 2"; INT (CONFLO%/64) +1 
600 PRINT“"RS232 cards 2“; INT (CONFHI%/2) AND 3 
610 PRINT"Printer cards 2": INT (CONFHI%/64) 

620 PRINT 
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Pascal 


630 END 

640 ! 

60000 CMM KKK HERI KKK KEKE AEE KKEKK 
60010 '* Initialize the Routine for interrupt-Call =: 
60020 8 tanner en ern rr enna Li 
60030 '* Input: none = 
60040 '* Output: IA the Start address of the interrupt-Routine ne 
60050 CHWARAE KEKKKKEKKKEKAEKEKAKAEKKEKKREKEKKEKKKKKEREKEKEKEKEKKKKKKEK I 
60060 ' 

60070 IA=60000! ‘Start address of the Routine in the BASIC-Segment 
60080 DEF SEG ‘Set BASIC-Segment 

60090 RESTORE 60130 

C1So FOR I$ = 0 TO 160 : READ X% : POKE IA+tis,X% : NEXT ‘Poke Routine 
60110 RETURN ‘back to Caller 
60120 ' 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 


listing: CONFIGP.PAS 


{ REAR RR RE KEK KEKE KEKE KEK KKK KEKE KK ERK KERR KK ERK KK EKER EEK KKK EEK K KEK EK KERKKKK ER | 


{* CONFIGP PASCAL ‘*} 
{* a a a a a ee re ne ee ee a ee cr ce a ne an ce ca ee ee ea ee ee ee Oe ee ee Oe ee ee *} 
{* Task : Outputs the Configuration of the PC on the *} 
Gal Display Screen *) 
{* a a re an re a re ee ee ee re ee ee ae ee ee ne ee ee *} 
{* Author : MICHAEL TISCHER “) 
{* developed on : 7/7/87 *} 
{* last Update : 5/18/89 a“ 


{BARRA AHR RRA KARE EKER ARERR AKAIKE HARARE AK AKEAIAKEKKEKH | 


program CONFIGP; 


Uses Crt, Dos; { Add DOS and Crt } 


{BARRA RRR RRR RRR KEKE KERR RIKKI KIRK RHE K KEK RIKER AREA KKK EKEKKEK ER | 


{* PRINTCONFIG: Display PC's configuration *} 
{* Input : none *} 
{* Output : none *} 
{* Info : The configuration output depends on the PC type =} 


[RRR R RRR RRR KEK RIK RHR IK KIKI KKK KKK KEK K KARR EKEKR EEK EKERKEREKEKKK KK } 


procedure PrintConfig; 


var AT : boolean; { is the PC an AT? } 
Regs : Registers; { Register variable for interrupt call } 
begin 
clrscr; { Clear screen } 
if mem[(SFOOO:SFFFE] = SFC then AT := true { test if AT or } 
else AT := false; { PC or XT } 
writeln('Configuration of this PC'); 
writeln (' --------------~------- --- -- -- - - - - - - - - -- - - = ib 
write ('PC-Type ae ie 
case mem[{SFOOO:SFFFE] of { Read PC type again } 
SFF : writeln('PC'); { SFF is a PC } 
SFE : writeln('XT'); { SFE is an XT } 
SFC : writeln('AT') { SFC is an AT } 


else writeln('Unknown') ; 
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end; 
write ('Processor : INTEL ‘); 
if AT then writeln ('80286') { the AT has an 80286, } 
else writeln ('8088'); { PC and XT have an 8088 processor } 
intr($12, Regs); 
writeln ('RAM~Memory : ‘,Regs.ax,' KB‘); 
if AT then { is the PC an AT? } 
begin { YES } 
Regs.ah := $88; { Function number for additional RAM size } 
Intr ($15, Regs); { Call BIOS cassette interrupt } 
writeln (‘additional RAM : ',Regs.ax,' KB beyond 1 MB‘); 
end;. 
Intr($11, Regs); { Call BIOS configuration interrupt} 
write ('Video mode after start : '); 
case Regs.al and 48 of { Determine video mode } 
0 : writeln('undefined'); 
16 : writeln('40x25 character color card'); 
32 : writeln('80x25 character color card'); 
48 : writeln('80x25 character mono card‘) 
end; 


writeln('Disk drives 
writeln('RS-232 cards 
writeln('Printer cards 
end; 


', succ(Regs.al shr 6 and 3)); 
‘, Regs.ah shr 1 and 3); 
‘, Regs.ah shr 6) 


{RA RKAKKHKK EKER KKK KE EKKEKERKKKKEKKKKEKKKEKKKKEKKEKKEREKEKKEEKEKE | 


i* MAIN PROGRAM *} 
{RHR RR RRR RK KIRK K KEK KKK RE RRR IRR RRR ERI IRI IKARIA IRA RAIA AAA IIIA | 


begin 
PrintConfig; { Display configuration } 
end. 


C listing: CONFIGC.C 


[RR RII KI IRI IIR KK IKK IK KEKE KK IK KER EERE TREK KIER EEK ERK KEEKKEEEKEKE / 


[* CONFIGC */ 
/* (Sn as cs i as aes ci ccs ses cos Sem coms Ss wn aon Sem Zs see ewes mcs es ces koe es ee anos as ms en es sees os mam oe cw on os ooh en oe a cs on ten One ese as x / 
/* Task : Outputs the configuration of the PC on the */ 
/* Display Screen */ 
/* Sse tc ec ns Sl ae Coes ee rs 'm  Sen Sak e acs as ea m en usis a nss"eums mccs Cans is ms es ae in Sa ik a cs ss casts ems aes ms sa cs fn con eh es ma ced ints eins nests as a/ 
{* Author : MICHAEL TISCHER wy: 
/* developed on =: 8.13.87 a d 
/* last Update : 9.21.87 a7 
/* ine aim cums outs eum cbs Si ai teres cams Gene ie Cove iu stp eas see is ees es ess mas ew eft comm cae es Gavn cues sn ‘on sss lm eh i in sis ‘Seis cs cn cei ts‘ ms Ses Mato cin dom ean Gus ems Gah Gem en hth CD Gn en ane‘ */ 
/* (MICROSOFT C) */ 
/* Creation : MSC CONFIGC */ 
/* LINK CONFIGC PEPO; */ 
/* Call : CONFIGC */ 
SJ a a td a a a a tS i ab eee aa as geen */ 
/* (BORLAND TURBO C) */ 
ae Creat ion : With the RUN command in the Command Line */ 


[ BRRKKKRKKEKREKKIAAKEKK AK KKK KIKI KEKE KKK KEEREEKEKRKEEKRKEKEKREKEKKKE / 


#include <dos.h> /* Include Header-Files */ 
#include <io.h> 


extern short int PeekB(); /* PEEKB linked with MicroSoft C */ 
#define FALSE 0 /* Constants make reading the */ 
#define TRUE 1 /* Program text easier */ 
[RIKER KEK KEKE IKE KEKE KK KEK KEKE KARR ARK IK KEKE K KERR EKER KKK KEKE KKKEKEEKEEEKEE / 
/* CLS: Clear Screen and Cursor to upper left corner ¢, ORF 
/* Input : none xy 
/* Output : none */ 


[ RRKKKKKREER EKER KEKE EKER KKK KKK EKER KEK EEK KE KEK EE KEREREEKEKREKREEKE / 


void Cls() 
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union REGS Register; /* Register-Variable for interrupt-Call */ 
/* Function number for Scroll-UP */ 

/* 0 for clear */ 

/* white characters on black background */ 
/* left upper screen corner */ 
/* Coordinates of the lower */ 
/* right screen corner */ 

/* Call BIOS-Video-interrupt */ 


Register.h.ah = 6; 
Register.h.al = 0; 
Register.h.bh = 7; 
Register.x.cx = 0; 
Register.h.dh = 24; 
Register.h.dl = 79; 
int86(0x10, &Register, &Register); 

ZF /* Set Function uutber. fut Cursut pusition */ 
Register.h.bh = 0; /* Screen page 0 */ 
Register.x.dx = 0; /* Coordinates of upper left screen corner */ 
int86(0x10, &Register, &Register); /* Call BIOS-Video-interrupt */ 
} 


Na wt ne nw ah 
NS YyLOLoL etleGaii — 


[Raa KKR KK KKK KKK KKK KKK KKK KKK KKK kK hk KKK KKK KKK KK KKK KEK KK KK KKK RK RK / 


/* PRINTCONFIG: Output the PC Configuration x] 
/* Input : none i 
/* Output : none a: 
/* Info : the configuration output dependent on the PC-Type x] 


[RRR KKK KKK KKK IKK KK KKK IKK IKK KKK AK KIEK RAK KIKKAK KK AKKEKKKK KK / 


void PrintConfig () 


{ 


union REGS Register; /* Register-Variable for interrupt-Call */ 
short int AT; /* the PC and AT? */ 


Cls(); 
if (PeekB(OxF0O00, OxFFFE) == OxFC) AT = TRUE; 
else AT = FALSE; 
printf ("CONFIG (c) 1987 by Michael Tischer\n\n") ; 
printf ("Configuration of this PC\n"); 
printf ("------~--- ----------------- --- - --- - - + en \n"); 
printf ("PC-Type ibe ie 
switch (PeekB(0xFO00, OxFFFE) ) 
{ 
case OxFF : printf ("PC\n"); 


/* Clear Screen */ 
/* Determine if the */ 
/* PC and AT */ 


/* Determine PC-Type again */ 


/* OxFF a normal PC */ 


break; 
case OxFE : printf ("XT\n"); /* OXFE an XT */ 
break; 
case OxFC : printf ("AT\n"); /* OxFC an AT */ 
break; 
default : printf ("Unknown\n") ; /* Code unknown */ 
break; 
} 
printf ("Processor : INTEL 80"); 


if (AT) printf ("286\n"); /* the AT has an 80286, */ 


else printf ("88\n"); 
printf ("RAM—Memory 
int86(0x12, &Register, 


printf ("%d KB\n",Register.x.ax); 


if (AT) 
{ 


Register.h.ah = 0x88; 
int86(0x15, &Register, &Register); 
printf ("additional RAM 


} 


int86(0x1l, &Register, &Register); 


/* PC and XT have an 8088 Processor */ 

aa 
&Register) ; /* Get RAM size */ 
/* and output */ 

/* the PC an AT? */ 
/* YES */ 

/* Function number for additional RAM */ 
/* Get RAM size */ 
: %d KB beyond 1MB\n", Register.x.ax); 


/* BlOS-Configuration-interrupt */ 


printf ("Video mode after Start : "); 
switch (Register.x.ax & 48) 


{ 


case 0 : printf ("undefined\n"); 


break; 


case 16 : printf("40*25 Character Color-Card\n"); 


break; 


case 32 : printf ("80*25 Character Colaor-Card\n") ; 
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break; 
case 48 ; printf("80*25 Character Mono-Card\n") ; 
break; 
} 
printf ("Disk drives : d\n", (Register.x.ax >> 6 & 3) + 1); 
printf ("RS232-Card : td\n", Register.x.ax >> 9 & 0x03); 
printf ("Printer-Card : $d\n\n", Register.x.ax >> 14); 
} 


[BERR IKKKE KEK KKK IKKE KK IKK KKK IKKE KK IKKE KEIR KK AK IKEEKEEEKKEKK KK / 


aes MAIN PROGRAM al A 


[RRR KKH REKRKEKKEKE KKK KAK KK KK IKKE KIK IKK ERE KKK KEKE KEKE KEKE KEKERKKEKEK KK / 
void main (} 


PrintConfig(); /* Output the Configuration */ 
} 
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7.7 Accessing the Floppy Disk from the BIOS 


A cassette recorder was the primary form of mass storage in the early days of 
personal computing. However, floppy drives soon became the standard. PCs can 
control a maximum of four disk drives, numbered 0 to 3. DOS designates the first 
two units as drive A and drive B. 


Early disk-based PC systems used only one side of disks for data storage. DOS 
Versions 1.1 and later store data on both sides of the disk. 


Disk structure 


Each side of a disk consists of 40 tracks of 9 sectors each. Each sector has a 
capacity of 512 bytes. The tracks are numbered from 0 to 39. Track 0 is located on 
the outer edge and track 39 on the inner edge of the disk. The two disk sides have 
designations of side 0 (front) and side 1 (back). This disk has a total storage 
capacity of 360K. 


The disk drives included with AT computers have 80 tracks with 15 sectors instead 
of 40 tracks with 9 sectors. An AT floppy drive can store up to 1.2 megabytes of 
data per disk. Systems with a 1.2 megabyte drive can read both 1.2 meg disks as 
well as 360K disks. 


Note: While it's possible to write 360K formatted disks using an AT type 
1.2 megabyte drive, the resulting disks are not always readable by a 
standard PC/XT 360K drive. 


The following shows the structure of a disk: 
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Track 1 
Track 2 
Track 3 


Sector 1 
Sector 2 


PTeTTTIT Tir rh 
PPT TTT TTT 


Structure of a disk 


This structure is based on DOS specifications. It's possible to program the disk 
controller directly or use the various BIOS functions to alter the disk structure. 
Some methods of copy protection take advantage of this capability to arrange the 
data on the disk in such a way that DOS cannot use the data directly. 


The methods of transferring data to or from the disk are identical. First the 
read/write head moves to the proper track. Since the disk moves constantly, the 
sector to be processed eventually passes by the head, allowing data transfer. 


BIOS makes some functions available for disk access at the lowest level. BIOS 
thinks of DASD (Direct Access Storage Device) rather than disk drives. 


A total of six BIOS disk functions can be accessed by calling interrupt 13H and 
passing the function number to the AH register. 


Function 0: Reset disk 


Function 0 resets the disk drive. The reset always executes automatically during 
system start, but should also occur when an error occurs during the call of one of 
these six functions. Before the interrupt call, function number 0 must be loaded 
into the AH register. After the execution of the function the error status is returned 
in the AH register. A value which indicates the type of error if any, is returned in 
the AH register after all 6 functions. 
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If a program calls the reset function without the disk drive previously reporting an 
error, error code 1 (function number not permitted) may be returned in certain 
cases, even though no error occurred. For this reason, the function should be called 
only after an error, and not after every disk operation. 


Function 1: Status 


Function 1 senses disk status without disk access. If it returns a value of 0 as a 
result, no error occurred. Another value represents one of the following error codes: 


0 
0 
0 
2 


md 
© 
em 
oO 


1H 
2H 
3H 
04H 
O6H 
08H 
O9H 
10H 
OH 
80H 


If one of these errors appear, the disk operation just completed has been repeated 
several times following a reset. Most of the time the repeated operation succeeds 
without an error. If not, the current program in memory should react to the error 
condition in a suitable manner and display an error message. 


Working with the functions presented here, a time-out error can occur frequently 
after a read operation. It usually occurs because of the speed decrease required to 
read the disk: The old speed cannot be resumed immediately after reading. 


Function 2: Read 


Function 2 reads disk data. The BIOS must know the location from which you 
want disk data read. This information is passed in the DL, DH, CL and CH 
registers: 


Drive number (0 to 3) | 


DH Disk side (always 0 for single sided disks) 
QO = Front side 
P| 1 = Back side 


First sector to be read (1 to 9/1 to 15) 
Track containing sector to be read | 
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Up to 9 sectors (PC/XT disk drives) or 15 sectors (AT disk drives) can be read 
using one function call. The AL register specifies this number of sectors. Since 
disk drives usually store data belonging together in sequential sectors, this enables 
fast data access (e.g., 9 x 512 bytes = 4.5K in one disk revolution). 


The address of a buffer in memory must be passed in registers ES and BX since the 
data transfer area has no fixed location in RAM in which it can reside. The ES 
register accepts the segment address of the buffer and the BX register accepts the 
offset address. 


The function returns the error status to the AH register, and the number of sectors 
read in the AL register. In addition to the AH register, a set carry flag (carry flag = 
1) signals the occurrence of an error. 


Function 3: Write 


Function 3 allows write access to the disk. It accepts arguments similar to those 
used in function 2 above: 


Number of the drive (0 to 3) 


DH Disk side (always 0 for single sided disks) 
a OQ = Front side 
1 = Back side 


First sector to be written (1 to 9/1 to 15) 
Track in which the sector to be written is located 


The value in the AL register indicates the number of sectors to be written, while 
the ES and BX registers indicate the address of the memory area from which the 
data should be read. The function passes the error stots in the AH register, and the 
number of sectors written in the AL register. The carry flag has the same meaning 
as in function 2. 


Function 4: Verify disk 
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Function 4 tests whether data is transferred properly to and from the disk. The 
BIOS bases correct data transmission on a cyclical redundancy check (CRC) value, 
instead of just comparing data in memory with data on disk. Using a CRC 
involves summing the value of each individual byte in a sector with a specific 
formula. Since most disk drives work well and have exceptional reliability, most 
programmers ignore this function. DOS only uses this function to test data that 
was transmitted to a disk in response to an active VERIFY ON flag. 
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The register setup is similar to functions 2 and 3 (see above), with the difference 
that the AH register must contain 4. Since the function doesn't need a buffer 
address, this function does not use the BX and the ES registers. 


Note: This function only works properly on a PC or an XT: ATs may 
return incorrect results. 


Function 5: Format 


The last function of interrupt 13H allows the user to format part of a disk. Disk 
formatting (e.g., with the DOS command FORMAT) is a requirement since disks 
used by the PC are soft-sectored. This means that software, not hardware, 
determines the positioning of the sectors and tracks on the disk. The operating 
system must install the tracks and sectors on the disk using this function. Sectors 
don't have to contain 512 bytes. This BIOS function lets you format 128, 256, 
512 or 1,024 bytes per sector. However, you must format a complete track. 


The function number (5) must be passed in the AH register. The AL register is 
loaded with the number of sectors to format the track with. This number can be 
less than the DOS default values of 9 or 15. The number of the track to be 
formatted is passed in the CH register. This track number must be a value from 0 
to 39 (PC/XT) or from 0 to 79 (AT). The number of the disk drive is passed in the 
DL register and the disk's side in the DH register. 


Besides this information, the format function also requires a field containing 
formatting characteristics, which is also needed by the functions for reading, 
writing and verifying a sector. The address of this field is passed in the ES and BX 
registers. The segment address is loaded in the ES register and the offset address in 
the BX register. 


This table contains an entry consisting of four bytes for every sector to be 
formatted: 


Track to be formatted 


Byte 2 Disk side (always 0 for single sided disks) 
O = Front side 
1 = Back side 


Number of sector 


Byte 4 Number of bytes in this sector 
0 = 128 bytes 
1 = 256 bytes 
2 = 512 bytes 
3 = 1024 bytes 


Even though the function already possesses the number of the track to be formatted 
and the disk side, these items appear here again for reasons of safety. The sectors 
are placed into this table sequentially, which assigns the first sector the logical 
number 1 and the second sector the logical number 7. 
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While the logical and physical numbers of the sectors usually agree in a disk drive, 
it makes sense in a hard disk to change the logical number of a sector instead of its 
physical number. The hard disk of the XT reduces access time for individual sectors 
by displacing the logical sectors by six in relation to the physical sectors. 


Also the number of bytes which a sector can accommodate does not have to be 
uniform, since each sector may be defined in the table. With this and other 
parameters of the table, copy protection can be developed based on formatting. 
Format-based copy protection cannot be processed by the operating system. 


In addition to information such as the disk drive and sector number passed to the 
BIOS functions during a call, the BIOS also requires a series of other items to 
enable some disk operations. These parameters are passed in the device parameter 
table. Such a table exists in the ROM BIOS, but you can install your own in 
RAM. The address of the new device parameter table must be placed into memory 
locations 0000:0078 to 0000:007B. These memory locations should contain the 
address of interrupt 1EH (the PC doesn't use this interrupt). 


DOS also offers the option of providing a unique device parameter table which 
changes some values of this table from the BIOS default, accelerating access to the 
disk drives. 


The table itself consists of 11 bytes. The first two bytes transfer directly to the 
disk controller. They indicate the step time and the DMA mode. The step time is 
the maximum time period in which the read/write head of the disk drive can move 
from one track to another. 


The second byte indicates the time the disk drive motor can continue to run after a 
disk operation. It defaults to 2 seconds since it assumes that this is the maximum 
amount of time between consecutive disk accesses. Disk access speed is quicker if 
the disk motor has already achieved operational speed and does not have to be 
brought up to speed again. The value in this memory location is based on the 18 
unit per second system clock, so a value of 18 represents running time of about 
one second. 
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The value in byte 3 indicates the number of bytes per sector for a write or read 
operation. It corresponds to the values for formatting a sector, so it normally 
contains the value 3 (512 bytes per sector). If you want to write or read sectors 
with other sector sizes, the proper value must be entered into this memory 
location. 


Byte 4 gives the maximum number of sectors per track. The PC/XT disk drive 
defaults to the value 9 in this location, while the AT defaults to the value 15 
decimal. 


Byte 5 of the table contains a value that represents the amount of empty space 
between the end of a sector and the start of the following sector. This space relates 
to the time BIOS must allow to elapse until the next sector appears under the 
read/write head (not units of length). The value for this memory location defaults 
to 42. 


Byte 6 determines the data transfer length, which has no influence on data 
transmission in most cases. 


Since formatting of a disk occurs through the magnetization of certain areas, the 
sizes of the non-magnetic spaces between sectors must be determined. Byte 7 
records this, and these spaces must be larger than the space between sectors in byte 
5 so that the beginning of a sector can be recognized properly. 


Byte 8 accepts the ASCII code of the character which fills a sector during 
formatting. The BIOS defaults to the division character V (ASCII code 246). 


After the read/write head moves from one track to another it requires a rest period 
to let the vibrations connected with the movement fade away. Then it can properly 
perform any disk accesses which follow. 


This rest period given in byte 9 of the table defaults to multiples of 1 millisecond. 
While the BIOS grants 25 milliseconds of rest, DOS only permits 15 
milliseconds. 


The last entry of the table in byte 10 gives the time duration during which the disk 
motor achieves operating speed. The value in this memory location defaults to 
multiples of 1/8 second. Even here DOS requires more from the read/write head 
than BIOS. It provides only a 1/4 second waiting period, as opposed to 1/2 second 
for BIOS. 
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High density disk drives 
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Part of the introduction of the AT included high density 1.2 megabyte disk drives. 
To ensure compatibility with earlier disk drives, they are capable of reading and 
writing 320/360K disks despite the increase to the higher capacity of 1.2 
megabytes. They can also recognize a change of the disk media. For support of 
this new capability, AT BIOS contains three new disk functions which are called 
through interrupt 13H like previous functions. 


The first of these new functions determines the drive type in use. During the 
function call, in addition to function number 15H, the number of the drive (0 or 1, 
2 reserved for the hard disk) must be passed in the DL register. The function 
returns the type of the drive in the AH register: 


If the drive detects a disk change it can be sensed with the help of function 16H. 
After calling this function by passing the value 16H to the AH register and the 
number of the drive (0 or 1), the function returns a number to the AH register 
which tells whether the disk was changed since the last disk access. If this register 
contains the value 6, the disk was changed. The value 0 indicates that no change 
took place. 


The last new function, function 17H, must be called before calling the formatting 
function (function number 5) on PC/AT or PS/2 machines to tell the controller 
how it should format the disk. It should format the disk in either the 320/360K or 
the 1.2 megabyte format. Besides the function number in the AH register and the 
drive number in the DL register, a code must be passed to the AL register 
indicating not only the format type, but also the type of disk drive in use. This 


code has the following meaning: 


1 format to 320/360K on a 320/360K-drive 
3 | format to 1.2 MByte on a 1.2 megabyte-drive 


format to 320/360K on a 1.2 megabyte-drive 
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Demonstration programs 


The disk monitor in this section combines all the functions you have read about so 
far. The monitor versions, written in BASIC, Pascal and C, all have the same 
basic structure. Let's examine this structure before looking at the individual 
programs. 


The beginning of each program initializes variables, configures the screen and 
resets the disk drives. Next the input loop executes; this loop is the center point of 
the program. It displays the program prompt DISKMON> and then waits for user 
input. After the user enters input and presses the <Return> key, the program 
ensures that this input calls an executable command. If the input is illegal, the 
program displays an error message and returns to the program prompt. Legal input 
calls the subroutine, function or procedure requested. 


All three programs support the Help, Format, Get, Fill, Constants and End 
commands. The Fill command fills a sector with one character. The End command 
terminates the program. There is no Write command in the monitor's command 
set. This is because the amount of coding required to create a window for editing 
the 512 bytes of a sector would have made the program listings too long. 


All disk access commands ask for the track and perhaps the sector number of the 
disk, but not the disk drive number or the disk side number. The program defaults 
to disk drive 0 (drive A:) and disk side 0. The Constants command lets you change 
these defaults so you can access another disk drive or disk side. This command also 
specifies the format parameter needed for an AT (i.e., what disk format should be 
used). 


Like all other user input, the program transfers this input to the BIOS instead of 
the program itself. This disk monitor checks the BIOS's reaction to the input. The 
BIOS returns an error message in response to illogical or false input. Every disk 
monitor command which accesses the disk drive reads the error status of the disk 
drive after command execution. An error message then appears on the screen as 
needed. 


Let's take a close look at the monitor commands: 


2 Entering a question mark (?) at the program prompt displays a list of 
the available commands. 


Get This overview includes a Get command which reads and displays a 
sector of the disk. An internal buffer stores the contents of this sector 
after input and displays the contents on the screen. Certain control 
characters such as carriage returns or linefeed are shown as character 
strings instead of as ASCII codes. For example, <CR> appears 
instead of an actual a carriage return, and <LF> appears instead of a 
linefeed. While reading a sector the program assumes that the sector 
has the standard format of 512 bytes. 
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Format The Format command formats the selected sector in a 512-byte 
format. Remember that a 360K disk can have a maximum of 9 
sectors per track and a 1.2 megabyte disk can have a maximum of 15 
sectors per track. You can assign fewer sectors, but you must specify 
at least one sector. 


Reset The Reset command resets the disk drives. It also can be called by 
various commands when the disk drive reports an error. If it's called 
by the user before an error occurs, this can cause an error message. 
Most disk error messages cannot cause damage to the drive. 


BASIC listing: DISKMONB.BAS 


LOD PE RARAAAKKKKKAAKKK ARAKI AEEEEREKRKEKEKREKKKKE | 


110 '* DIS KMONB be 
120 WTA ss ics ss cacao xc es eas cass os vena Sins os es emis Sack mons i im San Saas mb ec cass ces aa ss ms Ss ns tn Sel ems uss sa ec nin Gasp ca css Sum escape ct el emis ln rt 
130 '* Task : Diskmon is a small Diskette monitor based ne 
140 ‘* on the BlIOS-Interrupt 13 (h) = 
150 ** Author : MICHAEL TISCHER ne 
160 '* developed on : 07/24/87 os 
170 ** last Update : 05/20/89 le 
180 CMRI KKK KKK KEKE KEKE KEK KRKEKKE KEK KKKEKKKKKK KKK 


190 ' 

200 CLS : KEY OFF 

210 PRINT "WARNING: This Program should only be started if GWBASIC was" 
220 PRINT "Started from the DOS level with <GWBASIC /m:60000>." 

230 PRINT : PRINT"If this was not the case, please input <s> for Stop." 
240 PRINT “Else press any key ..."3 

250 AS = INKEYS : IF A$ = “s" THEN END 


260 IF AS = "" THEN 250 

270 DIM SECTOR%[255] ‘Stores Sectors to be read or written 
280 DIM FD%[29] ‘Formatting data (maximum 0-29 = 30 Words) 
290 GOSUB 60000 ‘Initialize Interrupt-Routine 
300 CLS ‘Clear Screen 
310 KEY OFF ‘Turn off Function key assignment 
320 COLOR 0,7 ‘dark characters on light background (invers) 
330 PRINT" DISKMON (c) 1987 by Michael Tischer ? = Help “ 
340 COLOR 7,0 ‘light characters on dark background 
350 VIEW PRINT 2 TO 24 ‘Lines 2 to 24 form a window 
360 DRS = 0 ‘access unit 0 (A) first 
370 SIDE%S = 0 ‘access the first Diskette side 
380 FTYP% = 3 ‘1.2 MB Diskettes in 1.2 MB drive 
390 DEF SEG = &HFOOO ‘Set BIOS-Segment 
400 IF PEEK (&HFFFE) = &HFC THEN AT% = - 1 ELSE AT% = 0 ‘test if AT 
410 DEF SEG ‘Set BIOS-Segment again 
420 GOSUB 50000 ‘Execute Reset 
430 GOSUB 51000 ‘Output Error message if necessary 
440 INPUT"DISK-MON>",ES ‘User input prompt 
450 IF ES = “" THEN 440 ‘no input --> repeat input prompt 
460 IF ES = "2?" THEN GOSUB 53000 : GOTO 440 ‘Display Help-Text 
470 IF ES = "yr" THEN GOTO 420 *Reset 
480 IF ES = “s“ THEN GOSUB 54000 : GOTO 430 ‘fill a Sector 
490 IF ES = "f" THEN GOSUB 55000 : GOTO 430 ‘format a Track 
500 IF ES = "g" THEN GOSUB 56000 : GOTO 430 ‘Read Sector and display 
510 IF ES = "c" THEN GOSUB 57000 : GOTO 440 ‘Input Constants 
520 IF ES = “e" THEN VIEW PRINT 1 TO 24: CLS : END ‘End Program 
530 PRINT"unknown Command!" : GOTO 440 

540 ! 

50000 Peete eee eee eee eee ee eeecee eee Preece eeeeeeee eres eee ese eee Seek bt bee eo) 
50010 ‘* Execute Reset of all Disk drives =" 
50020 '*-~~~~---~------—---- - - - - $n rn nn rrr a 
50030 '* Input : none ik 
50040 '* Output: DST% = the Diskette-Status a 
50050 '* Info : 2% is a Dummy-Variable = 
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50060 OHHH HK KKK KKK KKK RE KKK KK KKH EK KKK KKK KKK KEK KK KKK KKKEKKKKKKS 


50070 ! 

50080 DST% = 0 ‘Function number for Reset 
50090 INR%& = &H13 ‘Call BIOS-Diskette-Interrupt 13 (h) 
50100 CALL IA(INR&, DST%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%) 

50110 RETURN ‘back to caller 
50120 ' 

51000 CW HK KKK KEKE KKK KKK KEK KKK KE KEK KKK KKK KEKE KKKREKEKEKKEKKEKEKKKEKEEKEKS 
51010 '* Output Error Message based on the Diskette-Status = 
51020 '*---~--~----~---~-~--~—-~ ---- -  - 5 en nn iol 
51030 ‘* Input : DST% = Status of the last Diskette operation ie 
51040 ‘* Output: none ae 
51050 CHK HK KH KKH KKK IKK KKK KA KEKEKKEKKKEKKKAKKKAKKAKKKAKKKKKKKKK kkk kkk 
51060 ' 

51070 IF DST% = O THEN RETURN ‘O = everything o.k. 


51080 PRINT “ERROR: “; 

51090 IF DST% = &H1 THEN PRINT"Function number not allowed " : GOTO 50000 
51100 IF DST% = &H2 THEN PRINT“Address-Marking not found" : GOTO 50000 

51110 IF DST% = &H3 THEN PRINT"Write attempt on protected Disk" : GOTO 50000 
51120 IF DST% = &H4 THEN PRINT“Sector not found" : GOTO 50000 

51130 IF DST% = &H6 THEN PRINT"Diskette changed" : GOTO 50000 

51140 IF DST% = &H8 THEN PRINT"DMA Overrun" : GOTO 50000 

51150 IF DST% = &H9 THEN PRINT"Data transmission beyond segment border“ : GOTO 50000 
591160 IF DST% = &H10 THEN PRINT"Read Error" :; GOTO 50000 

51170 IF DST% = &H20 THEN PRINT"“Error of Disk-Controller™ : GOTO 50000 

91180 IF DST% = &H40 THEN PRINT“Track not found" : GOTO 50000 

91190 IF DST% = &H80 THEN PRINT"Time Out Error™ : GOTO 50000 

51200 PRINT"“Error ";DST%;" unknown" : GOTO 50000 


SL210: 

53000 UHHH HK KKH KKK IKK IKK TIKI K KKK EK KKK KKK KK KEKE KKK KEKE KKKEKEKEE I 
53010 ‘* Display Help-Text on the screen boy 
93020 8 ¥en nn nn nen een enn reer esa an a 
53030 '* Input : none sa 
53040 ‘* Output: none a 
53050 CREEK KK KKK KK KKK EK KEK KKKKK KKK KKK KK KK KKKKK KKK KEK KKEKKKKKKKEKEKKES 
53060 ° 


53070 PRINT 

53080 PRINT"C OMMAND OVERVIE W" 
53090 PRINT" --~--------~-- ----------------- " 
53100 PRINT“e = End" 

53110 PRINT“g = Get (Read) " 

53120 PRINT"s = Sector fill" 

53130 PRINT"“r = Reset" 

53140 PRINT"f£ = Format" 

53150 PRINT“c = Constants" 

53160 PRINT"? = Help" 

53170 PRINT 


53180 RETURN ‘back to caller 
53190 ° 

54000 UR KK KKK KK KKK KK KKK KKK KA KKK AK KEK KKK KKK KK KEKE EEK EEK KEKKKKKKKKEK 
54010 '* Fill a Sector ss 
54020 '*~----~--~-~--------~- ----- - ~- + ee x’ 
54030 '* Input : DR% = the Number of the unit addressed mS 
54040 '* SIDE% = the number of the Disk side addressed ne 
54050 '* Output: DST% = the Diskette status ia 
54060 '* Info : Z% is a Dummy-Variable ee 
54070 KKK KKEKKKKKKEKKKKKAK KKK KKK KKK KKK HKK KK KKK KKK KKK EKKEKEKKKKKKEKKKEK 
54080 ! 

54090 INPUT “Track : ", TRACK% ‘Track in which the Sector is located 
54100 INPUT "Sector : ", SECTORS% ‘Sector to be filled 
54110 INPUT "Character: ",Z$ ‘Fill Character 
54120 IF ZS = "" THEN ZS = CHR$ (0) 


94130 FOR I% O TO 511 : POKE VARPTR(SECTOR%[0]})+1I%,ASC(Z$) : NEXT 


54140 DST% = 3 ‘Function number for writing 
54150 INR%S = &H13 ‘Call BIOS-Diskette-Interrupt 13 (h) 
54160 NUM% = 1 ‘Number of Sectors 
54170 OFSLO& = 0 : OFSHI% = 0 ‘initialize Variables 
54180 SEG%& = -1 ‘Use BASIC DS for ES 


54190 NUM% = 1 ‘Number of Sectors to be read 
54200 OFSLO% = VARPTR(SECTOR%[(0]) AND 255 ‘LO & HI-Byte of the Offset 
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54210 OFSHI% = INT (VARPTR(SECTOR$[0]) / 256) ‘address of Var SECTOR%(0] 
54220 CALL IA(INR%, DST%, NUM%, OFSHI%, OFSLO%, TRACK%, SECTOR$, SIDE%, DR%&, 2%, 2%, SEG%, 2%) 


54230 RETURN ‘back to caller 
54240 ! 

55000 OW HK HHH KH KKK KEK KKK KKK KEKE KKK KKK KEK KKK KEKKEKKKKEKKKKKKKEKEK! 
55010 '* Format a Track ** 
55020 '*-—----------—------ —--- —--- ee ee = nt 
55030 '* Input : DR& = the number of the unit = 
55040 '* SIDE% = the number of the disk side we 
55050 '* FTYP% = Type of Disk drive ale 
55060 '* AT% = -1 if computer is an AT, otherwise 0 * 
55070 '* Output: DST& = the Diskette status ms 
55080 '* Info : 2% is a Dummy-Variable =* 
55090 CH HHH HK KKK IKK KK IKI KKK EK EK KEK KKK KKK KKK KEKE KEKKKEKEKEEKKKKKKKKEKEKS 
55100 ! 

55110 IF NOT(AT%) THEN 55150 ‘if not AT, then no format fitting 
55120 FKT% = &H17 ‘Set Function number for DASD Type 
55130 INR%& = &H13 ‘Call BIOS~-Diskette-Interrupt 13 (h) 
55140 CALL IA(INR&, FKT%S, FTYP%, 2%, 2%, 2%, 2%, 2%, DR&, Z%, Z%, 2%, Z%) 

55150 INPUT "Track : ", TRACK% ‘Number of Track to be formatted 


55160 INPUT “Number Sectors: ",NUM% ‘Number of Sectors to be installed 
55170 IF NUM% > 15 THEN 55160 ‘maximum of 15 Sectors can be installed 


55180 FOR 1% = 0 TO NUM%-1 ‘one entry for every Sector 
55190 POKE VARPTR(FD%[0])+1I%*4, TRACKS ‘Enter number of Track 
55200 POKE VARPTR(FD%[0])}+I%*4+1, SIDE% ‘Enter number of side 
55210 POKE VARPTR(FD% [0] ) +1%*4+2, 1%+1 ‘Enter Sector number 
55220 POKE VARPTR(FD%(0O])+1%*4+3, 2 ‘Format Sector with 512 Bytes 
595230 NEXT ‘Process Entry for next Sector 
55240 DST% = 5 ‘Function number for Formatting 
55250 INR% = &H13 ‘Call BIOS-Diskette-Interrupt 13 (h) 
55260 OFSLO% = 0 : OFSHI% = 0 ‘initialize Variables 
55270 SEG% = -1 ‘Use BASIC DS for ES 
55280 OFSLO% = VARPTR(FD%[0]) AND 255 ‘LO and HI-Byte of Offset 
95290 OFSHI% = INT(VARPTR(FD%[{0]) / 256) ‘address of Var. FD%([0} 
55300 CALL IA(INR%, DST%, NUM%, OFSHI%, OFSLO%, TRACK%, 2%, SIDE%, DR%&, 2%, 2%, SEG%, Z%) 
55310 RETURN ‘back to caller 
55320 ' 

56000 OW KKK KK KKK KKK EK KK KKK KKK IKK KI KKK KKKKKKKEKKKKKKKEAK KK 
56010 '* read a Sector and display oi 
56020 ' *--~-~---~-----—~----- --—- -- - — - - - nn r= xe 
56030 '* Input : DR% = the Number of the drive to be accessed a 
56040 '* SIDE% = the number of the Diskette side = 
56050 ‘* Output: DST& = the Diskette status x 
596060 ** Info : Z% is a Dummy-Variable aa 
56070 CWEEK KKK EK KK KKK KEK KEK KKK KKKK KKK KEKKKKEK KKK KKK KKK KK KKKEKKKEKEKE 
56080 ! 

56090 INPUT "Track : ", TRACKS ‘Track in which the Sector is located 
96100 INPUT “Sector: ",SECTOR% ‘the Sector to be filled 
56110 DST% = 2 ‘Function number for reading 
56120 INR& = &H13 ‘Call BIOS-Diskette-Interrupt 13 (h) 
56130 NUM% = 1 ‘Read a Sector 
56140 OFSLO% = 0 : OFSHI% = 0 ‘Create Variables 
56150 SEG$ = -1 ‘Use BASIC DS for ES 
96160 OFSLO% = VARPTR(SECTOR%[0]) AND 255 ‘LO and HI-Byte of Offset 


96170 OFSHI% = INT(VARPTR(SECTOR%[0]) / 256) ‘addr of the Var SECTOR$% [0] 
96180 CALL IA(INR%, DST%, NUM%, OFSHI%, OFSLO%, TRACK%, SECTOR%, SIDE%, DR&, 2%, 2%, SEG%, 2%) 


56190 IF DST% <> 0 THEN RETURN ‘on error do not output data 
56200 PRINT STRINGS (80, "-") ; 

56210 FOR I% = 0 TO 511 ‘process all Bytes of the Sector read 
56220 Z% = PEEK(VARPTR(SECTOR%$[0}) + I%) ‘get a Byte from the Sector 


56230 IF Z% = 0 THEN PRINT “<NUL>"; : GOTO 56350 

56240 IF 2% 7 THEN PRINT “<BEL>"; +: GOTO 56350 

96250 IF (Z% = 8) OR (2% = 29) THEN PRINT "<BS>"; : GOTO 56350 
56260 IF Z% = 9 THEN PRINT “<TAB>"; : GOTO 56350 

96270 IF 2% = 10 THEN PRINT "<LF>"; : GOTO 56350 

96280 IF Z% = 11 THEN PRINT "“<HOM>"; : GOTO 56350 

96290 IF 2% = 12 THEN PRINT “<FF>"; ; GOTO 56350 

96300 IF 2% = 13 THEN PRINT "“<CR>"; : GOTO 56350 

96310 IF Z% = 27 THEN PRINT “<ESC>"; : GOTO 56350 

96320 IF Z% = 30 THEN PRINT "<CUP>"; : GOTO 56350 


u 
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56330 IF 2% = 31 THEN PRINT "“<CDN>"; : GOTO 56350 

56340 PRINT CHRS (2%) ; ‘output Byte as ASCII character 
56350 NEXT ‘output next Byte 
56360 PRINT 

56370 PRINT STRINGS (80, "-") ; 


56380 RETURN ‘back to caller 
56390 ' 

57000 SwRI K KKK KKK KKK KKK K EEK KKKAKKKAKKKKKKK 
57010 '* Input Constants (Unit number, Diskette side, etc.) = 
57020 ! n-ne nee iia 
57030 '* Input : AT$% = -l1 if computer is an AT, else 0 salty 
57040 '* Output: DR& = Number of unit to be accessed “ss 
57050 '* SIDE% = Number of disk. side Bt 
57060 *4 FTyP% = Type of Disk drive e 


57070 CAREER KKK KKEKEKKKKEEKEKKKKKEKK KK KEKREKKKKK KKK KEKE KKEKKEKEKKKKEKKKKEKEKKE 


57080 ! 

57090 INPUT “Unit-Number (0-3) : ",DR%& 

57100 INPUT “Diskette side (0 or 1): ",SIDE% 

57110 IF NOT(AT%) THEN RETURN ‘Diskette format only for AT 
57120 PRINT“Formatting Parameter:" 

57130 PRINT” 1 = 320/360 KB diskette in 320/360 KB Drive" 

57140 PRINT" 2 320/360 KB diskette in 1.2 MB Drive" 

57150 INPUT" 3 = 1.2 MB diskette in 1.2 MB Drive -- Please input: ",FTYP% 


57160 RETURN ‘back to caller 
57170 * 

60000 DH KKH HK KKK KKK KEKE KKK KKK AK KEKE KKK KKK KREEKKKKKKEKEKKKEAKKKE 
60010 '* initialize the Routine for Interrupt call x 
60020 **---------~-~--------~+~-~---------------~---~----+~--+---~------ ne 
60030 '* Input : none me 
60040 '* Output: IA is the Start address of the Interrupt-Routine x 


60050 OH HK IKK TK KK KKK IKK KK KKK KI KEK KK IKK KAKA KK KKK KEK AKKAKEKKKKEKKKEKS 


60060 ! 

60070 IA=60000! ‘Start address of the Routine in the BASIC-Segment 
60080 DEF SEG ‘Set BASIC-Segment 
60090 RESTORE 60130 

60100 FOR I% = O TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘Poke Routine 
60110 RETURN ‘back to caller 
60120 ! 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0O, 91, 46,136, 71, 66,233,108,255 


Structurally this program resembles the other BASIC programs which have been 
presented. The main program with the input loop is in lines 300 to 540. Then 
follow the individual commands of DISKMON which exist as subroutines between 
lines 50000 and 57170. The subroutine for initializing the interrupt call starts at 
line 60000 (the program uses this interrupt frequently). 


The use of a BASIC variable as a buffer for the reading and writing of data is 
somewhat complicated in this program. The program dimensions an integer array 
with elements from 0 to 255. Since every element in this array requires 2 bytes 
(for integer), the program allocates 512 bytes for a buffer. The problem arises from 
the BASIC interpreters garbage collection routine. When it removes data, which is 
no longer needed, from the variable storage area, it also moves the data buffer. The 
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address of this buffer which was supposed to be passed to BIOS is no longer valid. 
Other data are now stored there. 


During a write operation this wouldn't be very bad, since only false data would be 
written to the disk. During a read operation this could lead to a crash of the BASIC 
interpreter, since variable memory could be destroyed. To prevent this, establish 
the address of the buffer variable immediately before the BIOS function call. Also, 
make sure that the variables which accept this address are constantly available. For 
this reason DISKMON initializes the two variables with 0 before storing the 
buffer address in them. This offset address must receive the segment address of the 
current BIOS function in the ES register. Since the BASIC data segment contains 
the buffer address, the contents of the Data segment register DS must be passed to 
ES. This is done by passing the value -1 for ES which causes the interrupt 
function to copy the contents of the DS registers to ES. 


listing: DISKMONP.PAS 


{ RR RARAA RARE RIKER HERE REIKI IKK KHER REE EEKKRKEKRAKKERKEEKKE | 


ity DIS KMONP *} 
{* es si ie na tb ia wens i ie it is i ni i cg eda ee ean i itv ns wien ei cm’ ec wi ie ein ee oi ih i si abl nan is ei eh ea he ge ea cep’ ah x} 
{* Task : DISKMON is a small disk monitor based on *} 
{* | the functions of the BIOS diskette *} 
{* interrupt 13 (h) *} 
{* is la iss ei esi i et eb si sh Sin ele ses ca ice es nd ss ag se lil Va i ea icc So see cg ag he lve a Gk *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 7/9/87 =} 
{* last update : 5/19/89 ™} 


{ RE AKKKKKRRKKKEKKEKRKKKRKERKEKREKREKEKKEEKKEKEKEKRKEKKEEKKEKKEKEKEKREKEKEREKEKEKKKKEKEKER | 


program DISKMON; 


— 


Uses Crt, Dos; { adds Crt and Dos features 


type BufferTyp = array [1..1] of char; 
FormatTyp = record { BIOS requires this information for 


} 
Track, { every sector of } 
Side, { a track to be formatted } 
Sector, 
Length : byte; 
end; 

var ErrCode : byte; { Error status after diskette operation } 
Command : string[1]; . { Command input by the user } 
FTyp, { Diskette type for formatting function } 
DriveNum, { Number of current drive } 
Side : integer; { Number of the current diskette side } 
Dummy : integer; { Dummy variable } 
AT : boolean; { is the computer an AT? } 
{ RR RRRKKK KEKE EEKEK KEKE RKEREK EKER EKEEKKEKEERK KER EKER KEKE REKEKREKKEKKEEKRE KE } 
{* RESETDISK: Reset for all attached disk drives si | 
{* Input : none *} 
{* Output : error status =) 


[RRR R EKER RRR RERRR ERK ER ERE RRR RRKEKKEREKEKEKREREREKRREKEKEKEKKEKKKEEKRE EE } 


function ResetDisk : integer; 


var Regs : Registers; { Register variable for interrupt call } 
begin 
Regs.ah := 0; { Function number for reset is 0 } 
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intr ($13, Regs); 
ResetDisk := Regs.ah; 
end; 


{ Call BIOS disk interrupt } 
{ Read error status } 


{RRR RH HII TR RT TTR TI I IK KK IK RIK IIR IKI IK IKK IT KK IK IIA RAK IK AIK HY 


{* GETDISKSTATUS: reads the error status *} 


{* Input : none 
{* Output : the error status 


=) 
a 


{IH HHT TOK I IIIT RIOR TOK TRI TOT KTOIIITOTOKIT IK TIK IK IT II IAAT IIIA IH IH | 


function GetDiskStatus : integer; 


var Regs : Registers; 


begin 


{ Register variable for interrupt call } 


Regs.ah := 1; { Function number for error status is 1 } 


intr($13, Regs); 
GetDiskStatus := Regs.ah; 
end; 


{ Call BIOS disk interrupt } 
{ Read error status } 


[RAK RARER RARE KKK KEKE KR K KERR EKKRE RAKE EKER KEKE KEHEEKEKEKKEKE EE | 
és 


X 


{* READSECTORS: read a certain number of sectors *} 


{* Input : see below 
{* Output ;: error status 


{ RRR RRR KKK RRR RR RIK KR KK KA KKK IK IKK AEA ERE EERE KRE KEE | 


function ReadSectors (DriveNun, 
Side, 
Track, 
Sector, 
Number, 
SegAdr, 


OfsAdr : integer; 
var NumRead 


{ Disk drive for reading 


{ Side or read/write head number 


} 
} 
{ track to be read } 

{ The first sector to be read } 
{ Number of sectors to be read } 
{ Segment address of the buffer } 
{ Offset address of the buffer } 


integer) : integer; 


var Regs : Registers; { Register variable for interrupt call } 

begin 
Regs.ah := 2; { Function number for reading is 2 } 
Regs.al := Number; { Set number of sectors for reading } 
Regs.dh := Side; { Set side number } 
Regs.dl := DriveNum; { Set drive number } 
Regs.ch := Track; { Set track number } 
Regs.cl := Sector; { Set sector number } 
Regs.es := SegAdr; { Set buffer address } 
Regs.bx := OfsAdr; 


intr($13, Regs}; 
NumRead := Regs.al; 
ReadSectors := Regs.ah; 
end; 


{ Call BIOS disk interrupt } 
{ Number of sectors read } 
{ Read error status } 


{RRR III I ITI KKK IK RK IK IK III HK KKK III HK IK IKK AIA IK HAITI HAKKAR K IK KKKAKKKK KK | 


{* WRITESECTORS: Write a certain number of sectors x} 


{* Input : see below 
{* Output : error status 


=] 
=} 


{ ARR R RR RE RRR HK IKE KK RR KEK RRR KK RRR KERIK HK RRR E KEKE REREKRKEKEKRKEKKKEEKE } 


function WriteSectors (DriveNum, 
Side, 
Track, 
sector, 
Number, 
SegAdr, 


{ Disk drive. } 

{ Side or read/write head } 

{ Track to be written } 

{ First sector to be written } 
} 
} 
} 


{ Number of sectors to be written 


{ Segment address of the buffer 


OfsAdr : integer;{ Offset address of the buffer 
var NumWritten : integer) : integer; 


var Regs : Registers; 


begin 
Regs.ah := 3; 


{ Register variable for interrupt call } 


{ Function number for writing is 3 } 
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Regs.al := Number; { Set number of sectors to be read } 
Regs.dh := Side; { Set side number } 
Regs.dl := DriveNum; { Set drive number } 
Regs.ch := Track; { Set track number } 
Regs.cl := Sector; { Set sector number } 
Regs.es ;:= SegAdr; { Set buffer address } 
Regs.bx := OfsAdr; 
intr($13, Regs); { Call BIOS disk interrupt } 
NumWritten := Regs.al; { Number of sectors written } 
WriteSectors := Regs.ah; { Read error status } 
end; 


{BARR RARER KR RRR RK K RIKER RHEE IK KKK HK KEK EKER K KKK KKAKKEREKEKEKKKKE EE | 


{* SETDASD: must be called for an AT before formatting to indicate *} 


{* if it should be formatted with 360 KB xt 
{* or with 1.2 MB *} 
{* Input : see below zh 
{* Output : none *} 


{ BEARER HERR KREKEKERKE KR KEKE KEK EKER KEK KEKE KEKE K EK KK KKK EKREKRKEKRKEKEKEEKKEKEKEKE | 


procedure SetDasd(DiskFormat : integer); 


var Regs : Registers; { Register variable for interrupt call } 
begin 
Regs.ah := $17; { Function number } 
Regs.al := DiskFormat; { Format } 
Regs.dl := DriveNum; { Drive number } 
intr($13, Regs); { Call BIOS disk interrupt } 
end; 


{REAR RRRRREKREKKKKRKRRRRKERRRKEKRRKRRKRKK IKEA KR ERK ERK KEKE KEKE KKEKEEKE | 


{* FORMATTRACK: formats a track *)} 
{* Input : see below *} 
{* Output : the error status al 


{ RAR R RARER RRR KKK RK KKK KKK KKK KKK AK AK KKK KKKK AKER EK KKK KKK KKKKEKKEKE | 


function FormatTrack (DriveNum, { Number of the disk drive } 


Side, { the side or head number } 
Track, { Track to be formatted } 
Number, { Number of sectors in this track } 


Bytes : integer) : integer; 


var Regs : Registers; { Register variable for interrupt call } 
DataField : array [1..15] of FormatTyp; { maximum 15 sectors } 
LoopcCnt : integer; { Loop counter } 
begin 
for LoopCnt := 1 to Number do { Create sector descriptor } 
begin 
DataField[LoopCnt] .Track := Track; { Number of the track } 
DataField(LoopCnt].Side := Side; { Diskette side } 
DataField[{LoopCnt].Sector := LoopCnt; { Number of the sector } 
} 


DataField[LoopCnt].Length := Bytes;{ Number of bytes in the sector 
end; 


Regs.ah := 5; 

Regs.al := Number; { Function number, Number } 
Regs.es := seg(DataField[1]}); { Address of the data field in } 
Regs.bx := ofs(DataField[1]); { registers ES and BX } 
Regs.dh := Side; { Side number } 
Regs.dl := DriveNum; { Drive unit } 
Regs.ch := Track; { Set track number } 
intr($13, Regs); { Call BIOS disk interrupt } 
FormatTrack := Regs.ah; { Read error status } 

end; 


{MERAH RAK RRR RAK KR K IK KIER K EKER KKK IK EK KEKE KEKE KKK KKKKER | 


{* WRITEERROR: Output error message according to error value *} 
{* Input : the error number a 
{* Output : none *} 
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(RIO I IO TIT TR II TOK TI IR KI TK IKK IIR IKK KKK RK IKK KK IK IAAI IKI KEKE ER 


procedure WriteError (ErrorNumber : integer); 


begin 


case ErrorNumber of 


$00 
$01 
$02 
$03 
$04 
$06 
$08 
$09 
$10 
$20 
$40 
$80 
else 
end; 


a 


writeln('ERROR: 
writeln('ERROR: 
writeln('ERROR: 
writeln('ERROR: 
writeln(‘ERROR: 
writeln('ERROR: 
writeln('ERROR: 
writeln('ERROR: 
writeln('ERROR: 
writeln(‘ERROR: 
writeln('ERROR: 
writeln('ERROR: 


{ 0 means no error } 
Invalid function number'); 
Address marking not found'); 
Write attempt on protected disk'); 
Sector not found‘); 
Diskette changed') ; 
DMA overrun'); 
Data transmission beyond segment border’); 
Read error'); 
Disk controller error'); 
Track not found‘); 
Time out error'); 
Error ',ErrorNumber,' unknown'); 


if (ErrorNumber <> 0) then ErrorNumber:=ResetDisk; { Reset performed } 


end; 


{BARA RRR RRR IRE KKK ERR KR KEE KKK EK KEK KEK KKK KEKEEKKEKK KEKE KEKEKKEKEKKEKKEEEE EE | 


{* CONSTANTS: 


{* 
{* 
{* Input 


Input of the two constants and *} 
diskette side or head number, as well as diskette *} 
type for AT is 
: none *} 


{* Output : none 
{RAH KRHA KK KKK KKK IK KKK KKK KHIR KKK KAKA KKK KK KKK KKKKKKKEKRKEKAKKKKEKEKE | 


procedure Constants; 


begin 


x 


write('Unit-Number (0-3) eee Bes 


readln ( 


DriveNum) ; 


{ Read unit number } 


write('Diskette side (0 or 1): ‘'); 


readln( 
if AT t 
begin 


Side); 
hen 


{ Read head number } 
{ only for AT } 


writeln('Format-Parameter:'); 
writeln(' 1 = 320/360-KB-Diskette in 320/360-KB drive'); 
writeln(' 2 = 320/360-KB-Diskette in 1.2-MB drive'); 


write(' 


read] 
end; 
end; 


n (FTyp) 


3 = 1.2-MB-Diskette in 1.2-MB-drive -- Please input: '‘), 


{RRR RR RRR KKK RK KKK KKK KKK KKK KKK KK KKK KEK KEKE KK KK KKK KEKKKKKER KE | 


{* HELP: Display help text on the screen *} 
{* Input : none ) 
{* Output : none *} 


{ ERA RRR KEK KEE REE KKK KR KEE KKK EK KEK KEK KKKKKEKKKKKKKKEKEKKKKEKEKEKEKEE | 


procedure Help; 


begin 
writeln(#13#10'C OMMAND OVERVIEW'); 
WELCOL RS HSS SSeS a Rear eee See etea aS ')? 


writeln('e = End'); 
writeln('g = Get (Read) '); 
writeln('s = Sector fill'); 
writeln('r = Reset'); 
writeln('f = Format'); 
writeln('c = Constants'); 
writeln('? = Help'#13#10) ; 
end; 


{ BARRERA RRR KKRKK KKK KK KKK KK KEKE KK KKK KKK KK KK ERK KKK KK KKKHKKKKKKKKKE EE | 


{* READSEC: Read a diskette sector and display it on the screen *} 
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{* Input : none *} 
{* Output : none =} 
{RRR RRR RH RRR KKK RIK IKKE KEKE KKK KK KEKE KKK KK ERE KK KEKE KKK EK KKK KKEK EE | 


procedure READSEC; 


var DataBuffer : array [1..512] of char; { the characters read } 
Track, { the track from which to read } 
Sector : integer; { Sector to be read } 
begin 
write('Track : '); 
readln (Track) ; { Read track from keyboard } 
write('Sector: '); 
readin (Sector) ; { Read sector from the keyboard } 


ErrCode := ReadSectors (DriveNum, Side, Track, Sector, 1, 
seg (DataBuffer), ofs(DataBuffer), Dummy); 


if (ErrCode = 0) then { Error occurred during reading? } 
begin 
WLite ( § mor nn nr nnn ee ‘+ 
for Dummy:=1 to 512 do { output the 512 characters } 
begin 
case DataBuffer[Dummy] of 
#00 : write('<NUL>'); { treat control characters separately } 


#07 : write('<BEL>'); 
#08 : write('<BS>'); 


#09 : write('<TAB>'); 
#10 : write ('<LF>'); 
#13 : write('<CR>'); 
#27 : write(‘<ESC>'); 
else write (DataBuffer [Dummy] ); { output normal character } 
end; 
end; 
write (#13#10 ' -------~------~~-----~~---~---~~------~------- ‘+ 
i a ais a nn Ss sees aps sheen leo Ses css ows res ate Se ‘nes ce cs Ss Gs an iss Sl es cle as es be) 
end 
else WriteError (ErrCode) ; { output error message } 
end; 


{ HARARE KKK KKK RR KKK KKK KK KKK KKK KKK KK KK KKK KKK KK KKK KKK KKKKKHAKKKKKKK HE | 


{* FORMATIT: format a certain number of sectors of a *} 
{* track with 512 bytes each a 
{* Input : none *} 
{* Output : none a 


{RRR TR IKI RIK IK IK IK KKK RK KEK KKK HRI KEK KEK KK IKKRKKKKKKRKKK KK} 


procedure FormatIt; 


var Track, { Track to be formatted } 
Sector : integer; { Number of sectors } 
begin 
write ('Track : '); 
readin (Track) ; { Read number of tracks from keyboard } 
write('Sector: '); 
readln (Sector); { Read number of sectors from the keyboard } 
if AT then SetDasd(FTyp) ; { if AT then diskette type } 
WriteError (FormatTrack (DriveNum, Side, Track, Sector, 2)); 
end; 


{RR RIKI IR KIKI IK IK RIK IKI KKK KIK IK RRA IK EKER KKK KKK | 


{* FILLSECTOR: Fill a sector with a character = 
{* Input : none x} 
{* Output : none *) 


[RRA R RRR RRR KR RRR IRR RRR IKK KKK KKK RK KKK KEK KKK EK KKK KK RK KEKE | 


procedure FillSector; 


var DataBuffer : array [1..512] of char; { Content of sector to fill } 
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LoopcCnt, 

Track, 

Sector : integer; 
FillChar : char; 


begin 

write (‘Track . ie 
readin (Track); 

write ('Sector 2 Sys 


readln (Sector) ; 
write('Character: '); 


readln(FillChar); 


for LoopCnt := 1 to 512 do 
DataBuffer[Loopcnt; <= FiiiCcnar; { Fili puffer with characters } 

WriteError (WriteSectors (DriveNum, Side, Track, Sector, 1, 

seg (DataBuffer), ofs(DataBuffer), Dummy) ); 


end; 


{ Track in which the sector is located 


{ Loop counter 


{ Number of sector to be filled 
{ the fill character 


{ Read track from keyboard } 


{ Read sector from keyboard } 


{ Read the fill character from the keyboard } 


{eee eee Eee RAK KH KKH KR KIRKE IKK KIKI KRHA ERR KEEKKREKKEEK EEE | 


{** 


MAIN PROGRAM he 


{RRR RR IR KK IK KKK IRI RRR IIR IAHR KR AKER RR IKE KKK KEK AKEERKEEE ED | 


begin 


clrscr; 
textbackground (7); 
textcolor(Q); 


writeln(' DISKMON: (c) 1987 by Michael Tischer ‘+ { Headline 


textbackground (0); 


} 
textcolor(7); { light text } 
window(1, 2, 80, 25); { only first line does not belong to window } 
DriveNum := 0; { Indicate unit 0 as constant } 
Side := 0; { Side 0 as constant } 
FTyp := 3; { 1.2 MB diskette in 1.2 MB unit } 
if mem[SFOOO:SFFFE] = SFC then AT := true { test if AT or } 

else AT := false; { PC or XT } 
WriteError (ResetDisk) ; { perform Reset } 
repeat 
repeat 


write ('DISKMON>'); 
readin (Command) ; 
until (Command <> ''); 
case (Command [1]) of 


oe 
‘rt 
tot 


* Help: 
: WriteError (ResetDisk); 
: FillSector; 


{ Clear screen 
{ light background 
{ dark characters 


? = Help '); 
{ dark background 


— 


{ output prompt 
{ Read command from keyboard 


~~) 


{? display help text 
{xr perform reset 

{s fill a sector 

{f format a track 

{g read a sector 

{c input constants 


if Command <> ‘et then writeln('unknown command'); 


‘f' : FormatIt; 
‘g' : READSEC; 
‘c': Constants; 
else 
end; 
until (Command = ‘e'); 
end. 


{e end program 


— 


The DISKMON in Pascal and the following version in C strongly resemble each 
other. Both have the input loop inside the main program and the individual 
commands placed in procedures or functions outside the main program. Unlike the 
BASIC version of DISKMON, a difference exists between the DISKMON 
commands and the BIOS function call. They are stored in separate program 
sections. This has the advantage that the BIOS function calls can be easily 
transferred as stand alone modules to other programs. 


Problems with addressing the data buffer don't exist in C or in Pascal as they do in 
BASIC. The buffer is a local variable. 
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There are two small differences between the C and Pascal versions. They are in the 
screen display and the administration of constants for unit number, disk side, etc. 
While the Pascal version defines these as global variables, the C version defines 
them as local variables within the main( program area. 


C doesn't allow easy window definition for performing tasks. This is why the C 
version of DISKMON doesn't use the first screen line as a status line to output a 
copyright notice and call the Help command. 


C listing: DISKMONC.C 
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[RRR REE IRIE KERRI KIER KERIKERI AK KKK f 


/* DIS KMONC */ 
/* su amr sus cru cos cv iG i es us cw ete eu Sn‘ oun in is im em in ib; mus sms cus esos to i ls emi Gem ls mutes si mas mb comes en ul ecu cams cna Gun ci Su es Gt i Geb cs em ais us Om wena */ 
/* Task : DISKMON is a short disk monitor program, */ 
/* using BIOS interrupt 13(h) functions */ 
/* a em cae cine an a Ge Oa ae ED cae OD me eS ew wre aU CEE cae aD Same Mine Mn MAND SONS tae ene eamD ns mb ED GED ine Gin DD eam GED cE SEED ED UD WD AD HD RED entD cat CRD wan SR Sake NEED ED SEED ct te ts GND SOS kin cite ibe meD GD EHD ED cu a/ 
f* Author : MICHAEL TISCHER */ 
/* Developed on: 08/15/1987 a 
/* last update . : 06/08/1989 ad 
Sf WD ts ieee eet otal a Te LS ae 2 hs Te eS */ 
/* (MICROSOFT C) */ 
f* Creation : CL /AS DISKMONC.C a 
, hess Call : DISKMONC = 
/* cs Sm ss ses ‘om mi ss mse ‘Gv em ew ss eo Sass i ni nn i Cn‘ a i Gm “mm a i ara Su en ch “nme Gat as cams Ses tm Se Sas Sea iss au mcm owas Scns ssn cms sows cog */ 
/* (BORLAND TURBO C) */ 
{* Creation : Make sure Case-sensitive link is OFF before */ 
{= compiling & linking */ 
/* Select Compile/Make or RUN (no project file) */ 


[RRR KR KKK KERIKERI RIKKI KEIR KIKI KKK IKARIA ARK EKKKEKEREKEEIAKK / 
#include <dos.h> 


#include <stdio.h> 
#include <ctype.h> 


typedef unsigned char byte; /* Create a byte */ 
#define FALSE 0 /* Constants to make reading the af 

#define TRUE 1 /* source code easier */ 
#define NUL 0 /* null character */ 
#define BEL 7 /* bell character code */ 
#define BS 8 /* backspace character code */ 
#define TAB 9 /* tab character code */ 
#define LF 10 /* linefeed character code */ 
#define CR 13 /* Return key code */ 
#define EF 26 /* End of file code */ 
#define ESC 27 /* Escape code */ 
/ t= Macro S =a SSS SS SSS SS SS SS SS ESS SS SSS SS / 
#ifndef MK FP /* MK FP still undefined? */ 


#define MK FP(s,o) ((void far *) (((unsigned long) (s) << 16) | (0))}) 
#define peekb(a,b) (*( (byte far *) MK FP((a), (b)))) . 
#fendif 


/*-- The following macros state the offset and segment addresses of --*/ 
/*-— any POINCY nnn nnn rn rr errr errr r= */ 
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#define GETSEG(p) ((unsigned) (((unsigned long) ((void far *) p)) >> 16)) 
#define GETOFS(p) ((unsigned) ((void far *) p)) 


/* -- Function declarations -----------3-n nnn ren nnn rn */ 


byte DRead( byte, byte, byte, byte, byte, byte far * ); 
byte DWrite( byte, byte, byte, byte, byte, byte far * ); 


/*== Structures =s==s==ss=s=sss2sssesssHssssessssssSseessssssssssssesesst / 
struct FormatDes { /* Describes format of a sector */ 
byte Track, 
Side, 
Sector, /* logical sector number */ 
Length; 


\; 


[RRR RHI IK IKK IIR TOT RTI ITOK TOT TOK IIIT IOI TOR IO OKI TIKI IK IRR KKK RK KR RK / 


/* RESETDISK: Reset all drives connected to system lj 
/* Input : none Lid 
/* Output : error status */ 


[HII KKK IK TR IK IKK IK IK KTR IK KR KK RIK TT IO IK IK RIKKI KIKI K KK / 
byte ResetDisk () 


{ 


union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 0; /* Function number for reset = 0 */ 
Register.h.dl = 0; /* Reset disk drives */ 
int86(0x13, &Register, &Register); /* Call BIOS disk interrupt */ 


/* printf ("Result: $d\n", Register.h.ah); */ 
return (Register.h.ah); 


} 


/* Return error status */ 


[ARIK KKK IKK KKK KKK KICK KI IK KIRK KK IK IKK KIKI KIKI KKK IK IK RAK RK KKK KK / 


/* WDS: Display status of the last disk operation */ 
/* Input : see below 47. 
/* Output : TRUE if no error, otherwise FALSE ny. 


[RII RI IK IOI RII ITI ITOK KITT IOTOT OT OT OI IOTOTTOTOTOR TORT RIT IIT KK IKK KICK / 


byte WDS (Status) 


byte Status; /* Disk status */ 

{ 
if (Status) /* Error occurred? */ 
{ /* YES */ 


printf ("ERROR: "); 

switch (Status) /* Display error msg */ 
{ 
case 0x01 : printf (“Function number not permitted\n"); 


break; 

case 0x02 : printf ("Address marking not found\n"); 
break; 

case 0x03 : printf("Disk is write-protected\n") ; 
break; 

case 0x04 : printf ("Sector not found\n"); 
break; 

case 0x06 : printf ("Disk changed\n") ; 
break; 

case 0x08 : printf(“DMA overflow\n"); 
break; 

case 0x09 : printf("Data transfer past segment limit\n"); 
break; 

case 0x10 : printf ("Read error\n"); 
break; 

case 0x20 : printf("Disk controller error\n"); 
break; 

case 0x40 : printf("Track not found\n"); 
break; 
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case 0x80 : printf("Time Out error\n"); 
break; 
case Oxff : printf("Illegal parameter\n"); 
break; 
default : printf("Error %d unknown\n", Status); 
} 
ResetDisk (); /* Execute reset on error */ 
} 
return (!Status) ; 


} 


[RRR KIKI KERR KHER KKK KKK KEKE KEKE REE KEKE EERE KEK KKK KKK KEEKE RK / 


/* DREAD: Read specified sector from disk ad 
/* Input : see below */ 
/* Output : error status */ 


[RRR RERKEEIKRRKIKKKEKEEIKKIK KI KKRKE KEKE KK EK KKEKEIKEKKEKIEKKKK KKK RK KKEKK / 


byte DRead (Drive, Side, Track, Sector, Number, Buffer) 


byte Drive, /* Drive number */ 
Side, /* Disk side or read-write head number */ 
Track, /* Track number */ 
Sector, /* First sector to be read */ 
Number, /* Number of sectors to be written */ 
far * Buffer; /* FAR pointer to a byte vector */ 
{ 
union REGS Register; /* Register variable for interrupt call */ 
struct SREGS SRegs; /* Variables for segment register */ 
Register.h.ah = 2; /* Function no. for read is 2 */ 
Register.h.al = Number; /* Number in AL register */ 
Register.h.dh = Side; /* Side in DH register */ 
Register.h.dl = Drive; /* Drive number in DL */ 
Register.h.ch = Track; /* Track in CH register */ 
Register.h.cl = Sector; /* Sector in CL register */ 
Register.x.bx = GETOFS ( Buffer ); /* Offset address of buffer */ 
SRegs.es = GETSEG( Buffer ); /* Segment address of buffer */ 
int86x (0x13, &Register, &Register, &SRegs); 
return (Register.h.ah); /* Return error status */ 


} 


[RRR IK IKK HRI KIKI KHIR KKK KKK KEK KEK KERIKERI KKK EAE KKK EKAKKEKE 


/* DWRITE: Write to the specified number of sectors */ 
/* Input : see below xf 
/* Output : error status */ 


[RRR KEKRKKK KEK KEKE KEK KEK KEKE KKK KKK EKER KEK KEKE KEKE KKK ERK KKK KEKE KKKKEKKEK / 


byte DWrite(Drive, Side, Track, Sector, Number, Buffer) 


byte Drive, /* Number of drive to be accessed */ 
Side, /* Disk side or number of read-write head */ 
Track, /* Track number */ 
Sector, /* First sector to be written */ 
Number, /* Number of sectors */ 
far * Buffer; /* FAR pointer to a byte vector */ 

{ 
union REGS Register; /* Register variable for interrupt call */ 
struct SREGS SRegs; /* Segment register variables */ 
Register.h.ah = 3; /* Function no. for write is 3 */ 
Register.h.al = Number; /* Number in AL register */ 
Register.h.dh = Side; /* Side in DH register */ 
Register.h.dl = Drive; /* Drive number in DL */ 
Register.h.ch = Track; /* Track in CH register */ 
Register.h.cl = Sector; /* Sector in CL register */ 
Register.x.bx = GETOFS( Buffer ); /* Offset address of buffer */ 
SRegs.es = GETSEG( Buffer ); /* Segment address of buffer */ 
int 86x (0x13, &Register, &Register, &SRegs); /* BIOS disk int. call */ 
return (Register.h.ah); /* Return error status */ 
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[RIKI IKK IK IK IK IK I KIKI RIK II III KIT KR KK IK IK IKK IKK IKK KEKE KKK KKK / 


/* FORMAT: format a track */ 
/* Input : see below ay 
/* Output : error status a 
f*® Inio : BYTES parameter gives the number of bytes in the for- */ 
is matted sector. The foiiowing codes are allowed: ued 
j* 0 = 128 bytes, 1 = 256 bytes Le 
7* 2 = 512 bytes, 3 = 1024 bytes +} 


J RAR III IH KIT IT TIO IK IO RIOD IR TT RIOT IT RIOT IT IO TTI IK TIT I IHR IK IAA KAKI IK IK / 


byte Format (Drive, Side, Track, Number, Bytes) 


byte Drive, 
Side. /* Side/head number */ 
Track, /* Track to be formatted */ 
Number, /* Number of sectors in this track */ 
Bytes; /* Number of bytes per sector */ 
{ 
union REGS Register; /* Register variable for interrupt call */ 
struct SREGS SRegs; /* Segment register variables */ 
struct FormatDes Formate[15]; /* Maximum of 15 sectors */ 
byte i; /* Loop counter */ 
if (Number <= 15) /* Is number 0.k.? */ 
{ 
for (i = 0; i < Number; i++) /* Set sector descriptor */ 
{ 
Formate[i].Track = Track; /* Track number */ 
Formate[i].Side = Side; /* Disk side */ 
Formate[i]}.Sector = itl; /* Sector increments by 1 */ 
Formate[i].Length = Bytes; /* Number of bytes in sector */ 
} 
Register.h.ah = 5; /* Function number for formatting */ 
Register.h.al = Number; /* Number in AL */ 
Register.h.dh = Side; /* Side number in DH */ 
Register.h.dl = Drive; /* Drive in DL */ 
Register.h.ch = Track; /* Track number in CH */ 
Register.x.bx = GETOFS ( Formate ); /* Offset addr. of table */ 
SRegs.es=GETSEG( Formate ); /* Segment address of buffer */ 
int86x (0x13, &Register, &Register, &SRegs); /* Call BIOS disk intr.*/ 
return (Register.h.ah); /* Return error status */ 
} 
else return (OxFF) ; /* Tllegal parameters */ 


} 


[RRR RIOT III IIIT IOI ITI IIIT OI TOR TOIT IIIT Kat / 


/* CONSTANTS : Change drive number, disk side and disk type a7] 
7* (PC/XT or AT) bal 
/* Input : see below ia 
/* Output : none xy 


[BRAK IRI IKK IK III RIK IK IKK IK TO IK RIK IK IIT IIT IKI IIH KKK IKK KKK AK KICK / 


void Constants (Drive, Side, FTyp, AT) 


byte *Drive, /* Pointer to drive variable */ 
*Side, /* Pointer to side variable */ 
FTyp, /* Disk drive type */ 
AT; /* TRUE if computer is an AT */ 


printf ("Drive number (0-3): "); 


scanf ("$d", &Drive); /* Read drive number */ 
printf ("Disk side (0 or 1): "); 

scanf ("%d", &Side); /* Read head number */ 
if (AT) /* Used only by ATs */ 


{ 

printf ("Format parameter:\n"); 

printf(" 1 = 320/360K diskette in 320/360K drive\n"); 

printf(" 2 320/360K diskette in 1.2MB drive\n"); 

printf(" 3 1.2MB diskette in 1.2MB drive - please enter choice: "); 
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scanf (“%d", &FTyp); 


} 
} 


[BRAKE IKKE KEK KEK KKK ERK KKK KKK KEK KKK KE KKK RE KK KKK KKK KIER EK KEKE KKK KEKKEKEKE / 


/* HELP: Display help screen i” § 
/* Input : none */ 
/* Output : none */ 


[RRR ERHK RK IKI KEK KK KKK KKK KIKI KEK KKK KIKI KKK KKK IK KKK KKK KEKE KKKKE / 


void Help () 


{ 
printf ("\nDISKMON (c) 1987 by Michael Tischer\n\n") ; 
printf("C OMMAND OVERVIE W\n"); 
PLInt £ (“wenn mewn nnn nnn nnn \n"); 
printf ("{E/e}] = End\n"); 
printf ("{G/g] = Get (read)\n"); 
printf("{S/s}] = Fill a sector\n"); 
printf ("(R/r] = Reset\n"); 
printf ("{F/f] = Format\n"); 
printf("(C/c] = Constants\n") ; 
printf ("{?] = Help\n\n"); 

} 


[ERK KR KEK KEKE KK KKK IKK IK KKK KKK KK KK KKK KER KKK KEK KKK KEKE KK KEKE KE KKEKEK KEE KKK KE / 


/* GET : Read a disk sector and display it on the screen */ 
/* Input : none ay. 
/* Output : none my, 


[RRR ERK KKK KKK IKKE KEKE KKK KK KEKE KKK KERR KKK KEK KKK KEKE EK KEKE KKKEKEKKKKKKEK KK / 


void ReadSector (Drive, Side) 


byte Drive; /* Drive number */ 
byte Side; /* Disk side number */ 
{ 
byte Buffer[512]; /* Contents of filled sector */ 
mc hy /* Loop counter */ 
Track, /* Track in which filled sector lies */ 
Sector; /* Number of sector to be filled */ 


printf ("Track : "); 


scanf (“%d", &Track) ; /* Read track number from keyboard */ 
printf ("Sector: “); 
scanf ("%d", &Sector); /* Read sector number */ 


if (WDS(DRead(Drive, Side, Track, Sector, 1, Buffer))) 
{ 


printf ("“------------------~----------------~----- ah 

printf ("“------------~---~------------------------ st 

for (i = 0; i < 512; i++) /* Display characters read from disk */ 
switch (Buffer[i]) /* ASCII code conversion */ 


{ 
case NUL : printf ("<NUL>"); 


break; 

case BEL : printf ("<BEL>"); 
break; 

case BS: printf ("<BS>"); 
break; 

case TAB : printf ("<TAB>") ; 
break; 

case LF : printf ("<LF>"); 
break; 

case CR : printf ("<CR>"); 
break; 

case ESC : printf ("<ESC>") ; 
break; 

case EF : printf ("<EOF>") ; 
break; 


default : printf("%c", Buffer{i]); 
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printf (“\nW--<---- 9-9 a nee nn en see =e = “); 
print £ ("“----- n-ne er rr nn en enn \n"); 
} 

} 


[RARE KKKKAEAKKKHKKKKEKAKKKKAKKKKKAKAKAKK KA KKK KAKK KAKA KKAAAKAKKAKKK AK KKAKK / 


/* FORMAT: Format a specified number of sectors in a track with tf 


/* 512 bytes */ 
/* Input : none x} 
/* Output : none a] 


[RII IH I KIKI KI IKI TKI RIKI KKK IKK IK IK IRI RK IKKE KKK EKER AKER IK / 


void FormatIt (Drive, Side, AT, FTyp) 


pyte vrive, /* Drive number */ 
Side, /* Disk side number */ 
AT, /* TRUE if computer is an AT */ 
FTyp; /* Disk drive type */ 
{ 
int Track, /* Track to be formatted */ 
Number; /* Number of sectors to be formatted */ 
printf ("Track ea 
scanf ("%$d", &Track); /* Read track number from keyboard */ 
printf("No. of sectors : "); 
scanf ("%$d", &Number); /* Read number of sectors */ 
if (AT) /* Is computer an AT? */ 
{ 
union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 0x17; /* Function no. for set DASD-Type */ 
Register.h.al = FTyp; 
Register.h.dl = Drive; 
int86(0x13, &Register, &Register); /* Call BIOS disk interrupt */ 


} 
WDS (Format (Drive, Side, Track, Number, 2, AT, FTyp)); 


} 


J FR II ITI ROK RKTT IOI IO TOK IIIT TOK TOK TORI TOK II KK KK RIK IKK AKA KKK / 


/* FILL : Fill a sector with a character xy 
/* Input : see below ats 
/* Output : none ia 4 


[RRR IIR IO IOI RRO IO IOI IIIT TOIT RII IORI TOTTI TK HK IK / 


void FillIt (Drive, Side) 


byte Drive; /* Drive number */ 
byte Side; /* Disk side number */ 
{ 
byte Buffer[{512]; /* Contents of sector to be filled */ 
int - i, /* Loop counter */ 
Track, /* Track in which the sector lies */ 
Sector; /* Number of sector to be filled */ 
char Character; /* Fill character */ 
printf ("Track or ee 
scanf ("%d", &Track); /* Read track number from keyboard */ 
printf (“Sector a rs 
scanf ("%d", &Sector); /* Read sector number from keyboard */ 
PEIN E("Prit whar. oo eye 
scanf("\rtc", &Character) ; /* Read fill character from keyboard */ 
for (i = 0; i < 512; Buffer[i++] = Character) 


WDS (DWrite (Drive, Side, Track, Sector, 1, (byte far *) Buffer)); 
} 


[RIKI IRI IK IK ITI IT ROR TOI IO TIO OIRO TO TOR TOT IIT RR IK / 


hie MAIN PROGRAM ad | 


[RR RII III IK IK II TTR IT TK KK IIR IOI TOT TOT IT TTR KTR IIT IT IIT RK IT KIKI TTT IIT KK / 
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void main() 


{ 


int Drive, /* Drive */ 

Side, /* Disk side */ 

FTyp; /* Disk and disk drive format */ 
byte AT; /* Computer type (AT or PC/XT) */ 
char Entry; /* Accept user input */ 
Drive = Side = 0; /* Default of drive 0, side 0 */ 
FTyp = 3; /* 1.2-MB diskette in 1.2-MB disk drive */ 
/*-- Read PC type from location in ROM-BIOS ------------------------- */ 


AT = (((byte) peekb(OxF000, OxFFFE)) == OxFC) ? TRUE : FALSE; 
printf ("\n\nDISKMON (c)} 1987 By Michael Tischer\n\n") ; 


WDS (Reset Disk ()); /* Execute reset first */ 
do 
{ 
printf("? = Help> "); /* Display prompt */ 
scanf("\r %1lc", &Entry); /* Get user input */ 
switch(Entry = toupper (Entry) ) /* Execute command */ 
{ 
case '?' : Help(); /* Display help screen */ 
break; 
case ‘R' : WDS(ResetDisk()); /* Execute reset */ 
break; 
case 'S' : FillIt (Drive, Side); /* Fill a sector */ 
break; 
case ‘F' ; FormatiIt (Drive, Side, AT, FTyp); 
break; 
case 'G' : ReadSector(Drive, Side); /* Read sectors */ 
break; 
case 'C' : Constants (&Drive, &Side, &FTyp, AT); 
break; 
default : if (Entry != 'E"') printf("Unknown command\n"); 
} 
} 
while (Entry != 'E'); /* “E" or “e" ends program */ 


} 
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7.8 Accessing the Hard Disk from the BIOS 


The original XT models included 10 megabyte hard disks. Hard disk drives are now 
the mass storage device of choice on PCs, with the floppy disk running a close 
second. However, the two devices have many features in common. 


Like the floppy disk, a hard disk consists of magnetized plates, also called disks, 
which can store data as magnetic impulses. Unlike the floppy disk, a hard disk 
contains severai of these disks. The plates in a hard disk can store data on both 
sides, and therefore must have a read/write head above and below each disk for 
reading and writing data. 


Hard disk format 


Hard disk formatting is similar to that of a floppy disk: Each disk is divided into 
tracks which have sectors within them. A cylinder consists of all sectors which can 
be accessed without moving the read/write heads. In other words, the heads remain 
Stationary within one cylinder while the disk moves beneath them. Moving the 
heads to another set of tracks accesses another cylinder. Every cylinder contains the 
same number of sectors, which in turn contain a constant number of bytes. 


Partitions 


The hard disk has another division beyond track, sector and cylinder levels: 
Partitions allow you to configure parts of a hard disk for different operating 
systems. Although you can format a disk according to one operating system and 
use that operating system exclusively, hard disks allow you to store several 
operating systems at once. You can allocate the number of cylinders needed for 
each operating system when formatting a hard disk. The first sector of the hard disk 
contains the information about this memory allocation. This information includes 
data about the beginning of each partition and its size, as well as which operating 
system lies in this partition (e.g., DOS has code 1). It also records which 
operating system is active and which operating system should be started during the 
system boot. 


XT and AT models can control hard disks capable of storing 10 megabytes, 20 
megabytes, 40 megabytes and more. Both hard disks have 2 disks (4 sides) 
(numbered 0 through 3) and accept 17 sectors per cylinder of 512 bytes each. The 
difference in capacity lies only in the number of cylinders. The XT hard disk has 
306 cylinders numbered from 0 to 305 on each side of its disk medium; the AT has 
615 cylinders numbered from 0 to 614 on each side of its disk medium. The XT 
hard disk has a minimum capacity of 10.16 megabytes and the AT hard disk a 
minimum capacity of 20.41 megabyte. 


Note: Exercise extreme caution when using the BIOS hard disk access 
functions. Unlike a disk drive which you can test out with an unused 
disk, you can't do the same with a hard disk. Careless use of the 
Write or Formatting function could lead to irretrievable data loss. If 
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you plan to try these functions, back up the entire hard disk before 
you try these functions. | 


BIOS accesses the hard disk through interrupt 13H—the same interrupt used for 


_ floppy disk access. The individual functions are identical for hard disk and floppy 


disk drives, but hard disk control is very different from floppy disk drive control. 
BIOS uses different modules for controlling the hard disk and disk drives. When 
you call interrupt 13H, it accesses the hard disk routine first. This routine tests 
whether the hard disk or floppy disk drive should be addressed, based on the device 
number in the DL register. If the hard disk is involved, it calls the proper routine 
in the hard disk module. On the other hand, if the floppy disk drive should be 
addressed, another module must be called by calling interrupt 40H, which points to 
the old disk interrupt 13H. 


All hard disk functions share the condition that after the function call they use the 
carry flag to signify whether they could perform their task or if an error occurred. If 
this is the case, the carry flag sets and an error code passes to the AH register. The 
individual codes have the following meanings: 


[OAH __| Sector defective 
j11H__| Read _error corrected with ECC 
Drive not ready | 
CCH 


When any one of these errors occur except error 01, execute a reset and try calling 
the function again. Most of the time the error won't recur. 


DMA transmission error: Segment border crossed 


More about errors 
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If error 11H occurs during the read function, the data read in may not actually be 
defective. This error indicates that a read error occurred, but that it could be 
corrected with the help of the ECC (Error Correction Code) algorithm. This 
procedure is similar to the CRC (Cyclic Redundancy Check) process used in the 
disk drives. A complicated mathematical formula adds the individual bytes of a 
sector. The result of the process goes to the disk in the form of a sector plus four 
bytes. If a read error occurs, it can be corrected within certain limits with the help 
of the stored ECC results. 
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The use of processor registers for data transmission becomes another parallel 
between the hard disk and floppy disk functions. The function number passes to 
the AH register. If the program requires the number of the hard disk to be 
addressed, it always passes to the DL register. The value 80H always stands for the 
first hard disk, and 81H for the second hard disk. The number of the read/write head 
(and indirectly of the disk addressed) passes to the DH register. The CH register 
accepts the cylinder number. Remember that a 10 megabyte hard disk has more 
than 306 cylinders. Since this 8-bit register can only address 256 cylinders at a 
time, this register alone isn‘t enough to indicate the cylinder number. 


For this reason bits 6 and 7 of the CL register help indicate the cylinder number. 
They form bits 8 and 9 of the cylinder number, permitting an addressable range of 
1,024 cylinders (0-1,023). Bits 0 to 5 of the CL register provide the number of the 
sector to address (they are numbered from 1 to 17 in each cylinder). If you attempt 
to access several sectors at a time, the numbers of these sections pass to the AL 
register. During read/write operations a buffer address must be indicated from which 
data can be read or to which data can be transferred. In such a case, the ES register 
passes the segment address and the BX register the offset address of this buffer. 


Function OOH: Reset 


Function OH resets the controller without the need of any other parameters. After 
an error occurs, this function should always be called before the next data access. 
The information from the hard disk on which the execution of the reset is based 
passes to the DL register. 


Function 01H: Status 


Function 01H reads the hard disk drive status (this status is indicated after every 
hard disk operation). The number of the drive whose status should be read must be 
stored in the DL register. 


Function 02H: Read sector 


Function 02H reads one or more sectors. A single call of this function can read up 
to 128 sectors. This limitation occurs because the hard disk controller transfers data 
directly into RAM through the DMA. The DMA chip can only transfer a 
maximum of 64K at a time, in one memory segment at a time. For this reason, it 
is important that the complete buffer whose address passes to ES:BX fits into the 
64K starting with the segment address in ES. Otherwise the DMA chip may report 
an error. 


This function initially reads all sectors in numerical order within the cylinder 
indicated, using the read/write head indicated. Once the function reads the last sector 
of a cylinder, and additional sectors should be read, reading continues with the first 
sector of the same cylinder, but using a different read/write head. After the function 
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accesses the last read/write head and additional sectors still remain, the read process 
continues in the first sector of the following cylinder on the first read/write head. 


Function 03: Write sector 


Function 03H writes one or more sectors. A single call of this function can write 
data in up to 128 sectors. This limitation is also caused by the DMA (see function 
02H above). 


This function initially writes all sectors in numerical order within the cylinder 
indicated, using the read/write head indicated. Once the function writes to the last 
sector of a cylinder, and additional sectors should be written, writing continues 
with the first sector of the same cylinder, but using a different read/write head. 
After the function reaches the last read/write head and additional sectors still 
remain, the write process continues in the first sector of the following cylinder on 
the first read/write head. 


Function 04H: Verify 


Function 04H verifies the different sectors of a cylinder. No comparison occurs 
between the data on the disk and the data in memory (no buffer address needed in 
ES:BX). ECC numbers verify whether the bytes stored return the same results after 
processing through the ECC algorithm. The AL register indicates the number of 
sectors to be verified. 


Function 05H: Format 
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Function 05H formats the hard disk. Before a hard disk can be accessed it must be 
formatted. Similar to the function used for formatting a disk, this function must 
know the read/write head and cylinder number. In addition, it must pass the address 
of the buffer to the register pair ES:BX. This buffer must be 512 bytes long, even 
if the function only accesses the first 34 bytes. It contains two bytes for each of 
the 17 sectors to be formatted. The first byte indicates whether the sector is in 
good condition. Assuming that every sector is in good condition, the value 0 is 
entered into this byte. The second byte accepts the logical number which should be 
assigned to the current sector. BIOS takes information from the first two bytes in 
the table about the first physical sector of the cylinder. Bytes 3 and 4 supply 
information about the second physical cylinder. Once the physical series has 
already been determined, the logical sequence of the sectors can be set through 2 
bytes of a sector indication in this table. 


The numbers differ between a logical sector and its respective physical sector. This 
shift in logical sectors, called sector interleaving, help optimize access time on a 
hard disk. 
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The average hard disk rotates at 60 revolutions per second. This means that the 
next physical sector appears under the read/write head every thousandth of a second. 
The hard disk controller is incapable of transferring the 512 bytes of the sector 
previously read into the PC's memory. For this reason, the logical sectors shift in 
relation to the physical sectors, so that the next logical sector only appears under 
the read/write head after the hard disk controller completes the transmission of the 
last sector. 


The interleave factor, i.¢., the number of sectors by which the iogical sectors shift 
in relation to the physical sectors, depends on the relationship between the speed at 
which the hard disk revolves, and the processing speed of the hard disk controller. 
For example, if the interleave factor is 6, this means that for every sector read, a 
"jump" of 5 sectors takes place before the next logical sector follows. The closer 
this factor comes to 1 (in which case the physical and logical sectors are identical), 
the faster the hard disk and the closer the transmission speed comes to the physical 
limit. 


While XT hard disks operate with an interleave factor of 1:6, AT hard disks are 
twice as fast, with an interleave factor of 1:3. The effects of the interleave factor 
and the relationship between logical and physical sectors can be seen in the 
following table: 


AT: physical logical 


sector 


During a function call, BIOS enters a value into the first byte of a sector marker 
which tells the calling program whether or not the sector is OK. The value 0 
means OK, and the value 128 means a magnetization error occurred. Besides the 
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registers mentioned above, the AL register accepts the number of sectors to be 
processed. Since the cylinders of the AT and XT hard disks have 17-sector formats, 
the AL register should contain the value 17 during the call of this function. 


Function 08H: Check disk specs 


Function 08H, passing the number of the hard disk in the DL register, checks hard 
disk specifications. This is important for examining hard disks with unusual 
formats. 


After the function call the DL register contains the number of attached hard disks. 
This number can be 0, 1 or 2. In addition, the DH register contains the number of 
read/write heads. Since the read/write head count always starts at 0, a value of 7 
means that 8 heads are available. The CL register (bits 0-7 of the cylinder number) 
and the upper two bits of the CH register (bits 8 and 9 of the cylinder number) 
indicate the number of cylinders. The counting here also starts at 0. The last 
information is found in the lower 6 bits of the CH register. It shows the number 
of sectors per cylinder, where the counting begins at 1 (an exception to the rule, 
since the other counts in this function begin with 0). 


When a user interfaces a foreign hard disk to a PC, the BIOS must know the 
characteristics of this hard disk to perform correct access. For this reason it uses 
interrupt 41H for hard disk 0 and the interrupt 46H for hard disk 1 as pointers to a 
table. This table has a format prescribed by BIOS and describes the attached hard 
disk drive. BIOS stores a whole series of tables so that BIOS can adjust itself 
properly during the system boot from the booting hard disk drive. 


Note: If the hard disk is already in the PC and functions properly, do not 
attempt to access the hard disk description table, since the hard disk 
could be damaged. 


A table must be constructed in RAM for foreign hard disk interfacing, and interrupt 
vectors 41H or 46H must point to this table. In addition, function 9 must 
configure BIOS to use this table. The number 9 declares the function. The number 
of the drive (80H or 81H) is loaded into the DL register. You may never have to 
use this complicated function: Most hard disk manufacturers include a 
configuration program which performs the same task. Check the documentation 
which came with the hard disk for the parameters needed for the hard disk 
description table. 


Function OAH: read ECC 
Function OBH: Write ECC 


Functions OAH and OBH are additional read/write functions. They differ from 


functions 2 and 3 in that they read and write the four ECC bytes at the end of each 
sector in addition to the 512 bytes of data. Because of this, every sector has 516 
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bytes instead of 512 bytes, and only 127 sectors can be read or written at one time, 
instead of 128 as in functions 2 and 3. 


Function OBH: Recalibrate 


Function OBH recalibrates one of two hard disks. It also returns the error status, 
passing the error number to the DL register. 


Function 10H: Check ready status 


Function 10H tests whether or not the hard disk whose number is in the DL 
register is currently prepared to execute commands. If the carry flag is set on the 
return of this function, the hard disk isn't ready. An error code passes to the AH 
register. 


Function 14H: Self test 


Function 14H forces the controller to perform an internal self test. If the controller 
is OK, it returns with a reset carry flag. 


Function 15H: Check drive type 


Function 15H determines the type of drive. The number of the drive (80H or 81H) 
passes to the DL register. If the drive is unavailable, it returns the value 0 in the 
AH register after the function call. If the AH register contains a value of 1 or 2, 
the device indicated is a floppy disk drive. The value 3 indicates a hard disk. If this 
is the case, the CX and DX registers contain the number of sectors on this hard 
disk. The two registers form a 32-bit number (the CX register contains the upper 
16 bits, and the DX register the lower 16 bits). 


Note: We chose not to include demonstration programs in this section, 
because accessing a hard disk without proper knowledge can have 
serious consequences. While floppy disk drive access can be practiced 
with an unused or empty disk without worrying about damage, you 
only get one hard disk with a PC. One small mistake during access 
could destroy all data on a hard disk. 


Avoid hard disk access using BIOS functions unless absolutely necessary. Leave 
these tasks to DOS functions as much as possible. 
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7.9 Accessing the Serial Port from the BIOS 


Computers in every part of the world communicate with each other and exchange 
data. Most of the time these computers use normal telephone lines for this 
communication. Phone lines only permit slow data transfer, but allow users to 
communicate from almost anywhere on the planet. Data transfers serially (1.¢., one 
bit at a time), while the sender and receiver maintain similar transfer protocols 
(parameters for data transfer). 


Serial card 


330 


Since basic PC configurations aren't equipped for this type of data transmission, 
data transfer is only possible when the user adds an asynchronous communication 
port (IBM's catch phrase for an RS-232 card, or serial interface card). 


This type of card enables data transfer between two computers direct through a 
cable or through phone lines. Both the sender and receiver require a modem to 
communicate using the latter method. Modems convert computer signals into 
acoustical signals which can then be transmitted over telephone lines. 


In addition to hardware, data communication requires software which controls the 
RS-232 card. BIOS offers this software in four functions called by interrupt 14H. 
Before discussing these functions in detail, let's examine data transfer protocol. 
Direction of data flow 
LSB MSB 


Oo 2-1 | | ) oe Se bit 


logical 1 


logical 0 


5-8 data bits 
(optional) 


Parity bit 
(optional) 
1, 1.5 or 2 
stopbits 
Start bit _—||Start bit of 
Line status next character 


Asynchronous transmission protocol 
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Word length 


Parity 


As the figure above shows, only the two line states, 0 and 1 (also called high and 
low) are important. The line remains high if no data transmission takes place. If 
the line's state changes to low, the receiver knows that data is being transmitted. 
Between 5 and 8 bits transfer over the line, depending on the word length. 
Unfortunately the BIOS functions only support a word length of 7 or 8 bits. If the 
line is low during data transmission, this means that the bit to be sent is 0. High 
signals a set bit. The least significant bit is transferred first, and the most 
significant bit of the character to be transmitted is transferred last. 


The character can be followed by a parity bit which permits error detection during 
data transmission. Parity can be even or odd. For even parity, the parity bit 
augments the data word to be transmitted, so that an even number of bits results. 
For example, if the data word to be transmitted contains three bits set to 1, the 
parity bit becomes 1 so that the number of 1 bits increments to four, making an 
even number. If the data word contained an even number of 1 bits, the parity bit 
would be zero. For odd parity the parity bit is set in such a manner that the total 
number of 1 bits is odd. 


Stop bits 


The stop bits signal the end of the transmission of data. Data transmission 
protocol permits 1, 1.5 and 2 stop bits. Some users are confused about the option 
of working with 1.5 stop bits, since some believe that you can't divide a bit. The 
explanation for this paradox comes from the data transmission protocol. 


Baud rate 


Old standards dictate that data transfers at a rate of 300 baud (about 300 bits per 
second), and one stop bit. The signal for a 1 bit and the signal for a 0 bit are both 
events. Binary bits when transmitted in an analog environment such as phone lines 
may not be identical with baud rates. Since stop bits always have the value 1, the 
line would be high for 1/300 second. If instead you keep the line high for 1/200 
second, 1.5 bits are transmitted. The line remains high until a new character 
transfers and sets the line transmitting the start bit to low. 


Some interfaces work with negative logic. In such a case the conditions for 0 and 1 
in the illustration above must be reversed. This doesn't change the basic principle 
of serial transmission. 


Protocol settings 


Data transmission only works if the sender and receiver both match various 
protocol parameters. First the baud rate (the number of bits transmitted per second) 
must be set. The standard baud rates for data exchange over voice telephone lines 
are 300, 1200 and 2400 baud. These baud rates depend on the capabilities of the 
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modem in use. For a dedicated (data only) telephone line or for direct data 
transmission through a cable, speeds up to 9600 baud are possible. Up to 80 bytes 
per second or 4800 bytes per minute can be transmitted at 9600 baud. 


The word length depends on the data being transmitted. If the data consists of 


normal ASCII characters, a 7-bit word is enough, since the ASCII character set has 
only 128 characters. If the data encompasses the complete PC set of 256 
characters, 8-bit words are more practical. 


Next the necessity of a parity check should be determined, and whether even or odd 
parity should be used. In most cases parity checking is recommended, since phone 
lines do not always transmit all data correctly. The parity selected is unimportant, 
as long as both sender and receiver select the same parity. 


The number of stop bits must be defined. One stop bit transmits successive 
characters faster than a setting of two stop bits. On the other hand, two stop bits 
increase the reliability of transmission. | 


Sample protocol 


UART 
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The following illustration shows a sample transmission of an "A" character with a 
protocol of 8 data bits, odd parity and one stop bit. Positive logic and a 300 baud 
transmission rate are assumed. Since the ASCII code of the "A" character is 65 
(01000001(b)) and therefore contains only two 1 bits, the parity bit changes to 1 
to set the number of 1 bits to an odd number. 


logical 1 » 


logical 0 


1/300 second 


8 data bits 
(01000001 (b) for “A") 


Transmitting A character: 8-bit word length, 1 stop bit, odd parity and 300 baud 


The brain of an RS-232 card is the UART (Universal Asynchronous Receiver 
Transmitter). You should be familiar with the design and capabilities of this 
processor, so that you can properly adapt programs to the error messages returned 
by the different BIOS functions. 


Abacus 7.9 Accessing the Serial Port from the BIOS 


Transfer registers 


A character transmitted on a data line passes first to a register designated as a 
transfer holding register. It remains there until processing ends on the character 
preceding it. Then the character moves to the transfer shift register from where the 
UART transmits the character bit by bit over the data line. Depending on the 
configuration, parity and stop bits implement the stream of data. When the BIOS 
function passes the status of the data lines to the AH register, bits 5 and 6 indicate 
whether these two registers are empty. 


Receiver registers 


The receiver shift register accepts received data, then transmits the data to the 
receiver data register where the UART removes the parity and stop bits. If a 
previously received character is still in the data register, bit 1 of the line status sets 
to 1 to avoid overwriting. Bit 0 indicates that a character was received. If while 
processing the character, the UART discovers that a parity error occurred during the 
transmission, it sets bit 2 of the line status. If a breakdown occurs in the agreed- 
upon protocol (number of parity and stop bits), the action sets bit 3. The UART 
always sets bit 4 if the data line remains longer in low (0) status than required for 
the transmission of a character. Bit 7 signals a time out error. This occurs 
occasionally when the communication between the RS-232 card and the modem 
isn't working properly. 


7 6 5 4 3 2 iL 0 bit 


O 


verwrite character | 
in data register 


Parity error 

Protocol not specified 
Line interrrupt 

Data register clear 


Shift register clear | 


Time out 


Line status 


Function 0: Passing protocol 


Before data can be transmitted or received, the UART must be informed of the 
number of stop bits, etc. Function 0 of interrupt 14H serves this purpose. The 
function number (0) enters the AH register, and the protoco! passes to the AL 
register. The bits of the AL register indicate the various parameters: 
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Dit. 0,1 Word ieagtn 
l1(b) - 8 bits 
Number of Stop bits 
0 - 1 Stop bit 
1 - 2 Stop bits 
bit 3,4 Parity check 
00(b) - none 
: O1(b) - odd 
10(b) - even 


bit 5 -7 |} Baud rate 


After initialization the function loads the line status into the AH register. 
Function 1: Transmit character 

Function 1 transmits characters. During its call, the AH register must contain 1 

and the AL register must contain the character to be transmitted. If the character 


was transmitted, bit 7 of the AH register changes to 0 after the function call. A 1 


signals that the character could not be transmitted. The remaining bits correspond 
to the line status. 


Function 2: Receive character 


Function 2 receives characters. After calling this function the AL register contains 


the character received. AH contains the value 0 if no error occurred, otherwise the 
value corresponds to the line status. 


Function 3: Line/modem status 


Function 3 senses and returns the modem status and line status. It returns the line 
Status in the AH register and the modem status in the AL register: 
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Bit 7 | Connection to receiver modem | 


Bits 4 to 7 represent a duplication of bits 0 to 3. Bits 0 to 3 indicate whether the 
contents of bits 4 to 7 have changed since the last reading of the modem status. If 
this is the case, the corresponding bit contains the value 1. For example, if bit 2 
contains the value 1, this means that the content of bit 6 has changed since the last 
reading. In reality it means that the phone just started to ring or has stopped 
ringing, depending on the previous value of bit 6. 
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7.10 The Cassette Interrupt 


The cassette interrupt (interrupt 15H) is a leftover from the days when PCs used 
cassette recorders exclusively as data storage devices. This interrupt provided four 
functions (numbered 0 through 3) for enabling and disabling the cassette recorder 
motor, reading from and writing to magnetic tape. As the PC gained ground in the 
business world, the disk drive became popular. Consequently, the cassette drive's 
popularity faded. 


The four cassette interrupt functions remain part of the PC's ROM-BIOS. The XT 
has no cassette recorder interface. In addition, the XT’s cassette interrupt consists of 
a short routine which sets the carry flag and stores an error code in the AH register 
to tell the program that the function called is unavailable. 


The AT and the cassette interrupt 


The cassette interrupt returned with the introduction of the AT. New functions can 
be called which have nothing to do with cassette recorder control. The following 
describes these functions, available only on AT models. 


Among other things, the interrupt makes two functions available based on the 
time measurement of the onboard AT realtime clock. The first of these is function 
83H. It is useful in situations where the CPU is engaged in a time consuming task 
(e.g., computing a complicated formula), but other duties must be performed at the 
same time (e.g., checking the keyboard to determine if the user wants to terminate 
the operation). 


Function 83H: Time flag 
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Function 83H calls the address of a flag (a byte in the user program) in which the 
highest level bit is set after a certain time period has elapsed. Within an executing 
program this flag can be tested after certain amounts of time. Only two assembly 
language instructions are necessary for this, so the testing requires little time. 
Function number 83H passes information to the AH register. The segment address 
of the flag is loaded into the ES register and the offset address into the BX register. 
The time that should elapse until the flag is set is passed to the CX and DX 
registers. Both registers form a 32-bit number which indicates the number of 
microseconds to wait (1 second = 1,000,000 microseconds). 


The CX register represents the upper 16 bits of this number. To calculate the total 
time, the contents of the CX register must be multiplied by 65,536 and the DX 
register must then be added to the total. If the waiting period is known in 
microseconds, the value for the CX and the DX register can be calculated: 


CX = int (Waiting period /65,536) 
DX = Waiting period mod 65,536 
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This function can only be called if the previous call of this function has ended (the 
time indicated has elapsed). If this is not the case, the function returns immediately 
with the carry flag set. 


Function 86H: Wait for end time 


Extended memory 


The second time function, function 86H, differs from function 83H in that it waits 
until the time indicated has elapsed. For this reason the function number must pass 
to the AH register, and the waiting time to the CX and DX registers during the 
function call. To convert the waiting time into two values for the CX and DX 
registers, the formula above can be used. This function can only be called if 
function 83H was not called previously, and if the time period set during its call 
has not yet elapsed. In such a case, the function returns immediately with a set 
carry flag to the calling program. 


The AT accepts more than 640K of memory. This additional memory (called 
extended) begins at 1 megabyte and cannot be accessed in real mode, in which the 
80286 processor operates as an 8086 processor. Function 88H determines the 
availability and size of this memory. Placing a value of 88H in the AH register 
returns the size of RAM beyond the 1 megabyte boundary (excluding RAM from 0 
to 640K) in 1K increments in the AX register. 


Function 87H: Move memory block 


Global 


Function 87H moves blocks of memory within the total memory space. This 
means that blocks of memory can be moved from the area below the 1 megabyte 
limit to the area above the 1 megabyte limit, and the other way around. The 
function should not be used for the latter, since its call is complicated and has 
other disadvantages. To access memory beyond the 1 megabyte barrier, the 
processor must be switched into protected mode (full 80286 mode). Function 87H 
requires very comprehensive information, since the 80286 processor is more 
difficult to program in protected mode than in real mode (8086 emulation under 
DOS). See the end of this section for a program which demonstrates the use of 
function 87H. 


The function number 87H must first be passed to the AH register, then the number 
of the words to be moved (words only—not bytes) must be passed to the CX 
register. A maximum value of 8000H corresponds to a maximum value of 64K. 


Descriptor Table 


The ES:SI register pair receive the address of the GDT (Global Descriptor Table), 
which must be installed in the user program. The GDT describes the individual 
memory segments of the 80286 in protected mode. The segments in protected 
mode are exempt from the limitations made in real mode. While segments can 
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only start at memory locations divisible by 16 in real mode, protected mode 
segments may start at any memory location. Furthermore, protected mode 
segments may be any size from 1 byte to 64K. 


Another protected mode innovation is the access code defined for every segment. It 
indicates whether the segment described is a data segment or a code segment (only 
code segments can be executed). The access code also contains information on 
access priority, and whether access is even permitted. Every segment descriptor 
consists of 8 bytes apiece. Function 87H expects during its call that six segment 
descriptors have been prepared in the GDT (i.e., memory space reserved for them). 
The figure below illustrates which segment descriptors are involved, as well as the 
construction of a segment descriptor. 


Segment descriptor 
Segment length 
Bits 0-15 of segment address +10H 
START 
Bits 16-23 of segment address +18H 
Bits 16-23 of segnent address DEST. 
+28H 
Reserved (always 8) STACK 
: : +30H 


G DT Addr. 


Addr 
+0 


+2 


+4 


+5 


+6 


+8 


Segment descriptor structure as seen by function 87H 


Only the segment descriptors designated as start and destination are of interest here, 
since the BIOS functions fill out the other descriptors. The first describes the 
segment from which the data are taken. The destination descriptor describes the 
segment into which the data are copied. The length of both segments can be 
OFFFFH (64K decimal), even if fewer bytes (or words) copy over in the process. If 
a lower value is indicated, do not allow the number of bytes (number of words 
multiplied by 2) to be copied to exceed this amount. Otherwise the processor 
notices an access across a segment boundary during copying, which triggers an 
error. The address of the two memory areas must be converted to a (physical) 24- 
bit address. The lower 16 bits of this address enter the second field of the segment 
descriptor and the upper 8 bits enter the third field. As access code 92H can be 
used, which signals the processor that the described segment is a data segment with 
the highest priority; that the segment exists in memory; and that the segment can 
be written. The last field of the descriptor exists for reasons of compatibility with 
the 80386 processor, and should always contain the value 0. 


While the address of the user program's buffer stays fixed, the address beyond the 1 
megabyte boundary to which data should be copied can be freely selected (subject 
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to RAM availability). The following table shows the addresses of the various 1K 
blocks beyond the 1 megabyte border as 24-bit addresses. 


O K = 100000H 124 K = 11F000H 
1K = 100400H 125 K = 11F400H 
2 K = 100800H 126 K = 11F800H 
3 K = 100C00H 127 K = 11FCOOH 
4 K = 101000H 128 K = 120000H 
9 K = 101400H 129 K = 120400H 
6 K = 100800H 130 K = 120800H 
7 K = 100C00H 131 K = 120CO0H 
8 K = 102000H 132 K = 121000H 
9 K = 102400H 133 K = 121400H 
60 K = 10F000H 252 K = 13F000H 
61 K = 10F400H 253 K = 13F400H 
62 K = 10F800H 254 K = 13F800H 
63 K = 10FCOOH 255 K = 13FCOO0H 
64 K = 110000H 256 K = 140000H 
65 K = 110400H 257 K = 140400H 
66 K = 110800H 258 K = 140800H 
67 K = 110C00H 259 K = 140C0O0H 
68 K = 111000H 260 K = 141000H 
69 K = 111400H 261 K = 141400H 


After the function call the carry flag indicates the success of the function call. If 
the carry flag sets, an error occurred. The value in the AH register indicates the 
cause of the error: 


RAM parity error 


A disadvantage of this function is that while the processor is in protected mode, all 
interrupts must be suppressed. The reason is the fact that during the protected 
mode, BIOS interrupts (e.g., timer or keyboard) can be called, but these routines 
were developed for operation in real mode only. These interrupts may not work 
properly in protected mode. The disadvantage can be clearly seen when you call the 
timer. Since its interrupts are suppressed, protected mode performs no time 
measurement, and time remains frozen for a moment. If programs call function 
87H frequently, the clock may run slow by 20 or 30 seconds in one day. The clock 
can be reset easily to the proper time with software, so software can bypass most 
of the disadvantages. 


Function 89H: Protected mode 


Function 89H switches the AT into protected mode. Only someone developing his 
Own operating system may have any interest in this function. Any system capable 
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of multiprocessing must run in protected mode. This function goes far beyond the 
scope of this book. See the AT technical manual for more information. 


Function 84H: Joystick reader 


Function 84H reads two joysticks connected to the AT. Two sub-functions operate 
within this function: Both return a set carry flag if the adaptor to which the 
joysticks should be connected doesn't exist. 


The first sub-function executes by passing the function number to the AH register 
and the value 0 to the DX register. It returns the status of the joystick fire buttons 
in bits 4 to 7 of the AL register. 


The second sub-function executes by passing the function number to the AH 
register and the value 1 to the DX register. It returns current joystick positions 
using X- and Y-coordinates. The X-coordinate for the first joystick can be found in 
the AX, and the Y-coordinate in the BX register. For the second joystick, the CX 
register contains the X-coordinate and the DX register the Y-coordinate. 


Function 85H: Read SysReq key 
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The <System Request> key on the AT keyboard triggers an interrupt without 
producing a character code. It cannot be tested with the BIOS keyboard reading 
functions. Function 85H reads the keyboard for the <System Request> key. 
Passing the function number to the AH register executes the function. The current 
BIOS version doesn't implement this function within the cassette interrupt. 
Usually the <System Request> key does nothing when the user presses it. 
However, a machine language routine can assign a special application to the 
<System Request> key. This program must only "deflect" interrupt 15H to its 
own routine. If it's called by a user program or by the system, a user routine 
executes instead of the cassette interrupt. It can test whether the AH register 
contains the function number 85H. If this is not the case, it calls the old cassette 
interrupt. If the AH register contains this function number, the user routine 
performs the desired action. 


The content of the AL register is also important to this user routine because it 
indicates whether the user pressed or released the <System Request> key. 0 means 
activated, 1 released. 
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Demonstration programs 


Of all the functions made available by this interrupt, the most interesting 1s 
probably function 88H. It permits the owners of ATs with memory beyond the 1 
meg limit to use memory that is inaccessible to DOS. The programs presented in 
this section demonstrate easy calls to function 87H within user programs. To 
illustrate the function call, each one of these programs copies the current video 
RAM contents directly beyond the 1 megabyte memory border. It then erases the 
video RAM and restores it again. The core of these programs is always the routine 
which calls function 88H of interrupt 15H. it constructs a GDT for this, enters the 
addresss of the start and destination area, as well as the GDT. First it converts the 
two addresses (passed as segment and offset addresses) into a 24-bit-wide address. 
This routine must be constructed first in assembly language for the higher level 
languages, then integrated into the higher level language programs. You'll see how 
this is done in the documentation of the individual listings. To avoid detailed 
comparison of the various assembler programs for linking into the move function, 
the difference lies almost exclusively in the area of the variable passing. Otherwise 
the programs are almost identical. 


BASIC listing: MOVE.BAS 


LOD PERAK AK KH KEKE KEKE EKKEKEKKEKRKKEKRKKEKKEKREKKEKKAKEKKEKREKEEKKEKKKKKK 


110 '* MOVE = 
120 CAG oe oe eee ee eee eae eee eee oe eae Sa ee ee ee ew ee eee ee ee eae * 
130 '* Task : uses the Routine for moving a storage area = 
140 ‘* to store the Video-RAM itd 
150 '* Author : MICHAEL TISCHER za 
160 ‘* developed on : 7.22.87 _, 
170 ‘* last Update : 9.21.87 ad 
180 CMMI KKK KKKKKKKKKKKKKK KKK KKK 
190 ! 

200 CLS : KEY OFF 


210 PRINT“WARNING: This program can only be started if the GWBASIC " 

220 PRINT"was started from the DOS level with <GWBASIC /m:60000>" 

230 PRINT : PRINT“If this is not the case, input an <s> to Stop " 

240 PRINT"Else, press any key..."; 

250 AS = INKEYS : IF A$ = “s" THEN END 

260 IF AS = “"" THEN 250 

270 CLS ‘Clear Screen 

280 PRINT"MOVE (c) 1987 by Michael Tischer" : PRINT 

290 PRINT“This Program uses Function 87(h) of Interrupt 15(h} to copy blocks " 
300 PRINT"of memory between the ‘normal' RAM and the RAM beyond the " 

310 PRINT“1-Megabyte border." 

320 DEF SEG = &HFO0O ‘Set BIOS-segment 

330 IF PEEK(&HFFFE) = &HFC THEN 380 ‘test if AT 

340 PRINT“Since this unit is not an AT, but a PC or * 

350 PRINT“XT, and they do not have memory the 1-MB limit, “" 

360 PRINT“this program can not be executed! Sorry..." 

370 END ‘Terminate Program (PC or XT) 
380 PRINT“The Program will first copy the current display immediately beyond the " 
390 PRINT“1 MB border and thens clear the screen. If you then press a key, “ 
400 PRINT“the old screen content is restored." 

410 PRINT : PRINT“Please activate a key to start the program..."“; 


420 AS = INKEYS ; IF A$ = *" THEN 420 ‘wait for key 

430 STARTS% = VIDEOS% : STARTO% = O ‘Start-area is Video-RAM:0000 

440 GOSUB 60000 ‘install Function for Interrupt call 
450 GOSUB 61000 ‘install Function for copying memory 
460 GOSUB 50000 ‘get current Video mode 


470 IF VMODE% = 7 THEN VIDEOS% = &HBOO0O ELSE VIDEOS% = &HB800 
480 STARTO% = 0 : STARTS% = VIDEOS%S ‘Start address is the Video-RAM 
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490 DESTS% = 0 : DESTO% = 0 ‘destination area is 10000:0000 

500 DIRECTIONS = 1 ‘copy from below to above 1 MB 

510 SIZE% = 2000 ‘the size of the Video-RAM is 200 Words 
520 GOSUB 51000 ‘move memory 

930 CLS ‘clear screen 


540 PRINT*Please activate a key ..." 


5950 AS = INKEYS : IF A$ = "" THEN 550 ‘wait for key 

560 STARTS%$ = 0 : STARTO% = 0 ‘Start area is 10000:0000 

570 DESTS% = VIDEOS% : DESTO% = 0 ‘Destination area is Video-RAM:0000 
580 DIRECTIONS = 2 ‘copy from above to below 1 MB 
590 GOSUB 51000 ‘move memory - 

600 LOCATE 15,1 ‘Set Cursor to column 1 of line 15 
610 END 

620 ' 

50000 CRE KKKEKRKKKEKRKKEKKEKEKKEEKEEKEKKKKEKKKKEEKKKEEKEKKEKKEKEKEKEKEKEEKES 
50010 '* Sense current Video Mode lhe 
50020 8 Bn nn en en re rn enn enn =s 
50030 '* Input: none ae 
50040 ** Output: VMODE% = the current Video mode cai 
50050 '* Info : the Variable 2% is used as Dummy a3 
50060 UM HMM KKH KKK KKK KKK KKK KKK K ERE KKK EKKKKEKEREKHEEEKKKEKAKKKKKS 
50070 2%=15 ‘get Function number for Video mode 
50080 INR$=&H10 ‘call BIOS-Video-Interrupt 16 (h) 
50090 CALL IA(INR$&, Z%, VMODE%, PAGES, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, Z%) 

50100 RETURN ‘back to caller 

50110 ' 

51000 CHK KKK KKK KK KKK KKK IRR KKK KEKE KKK KKK KEKE KK KKK KEK KKKEKEKKKKKEKKKEKKER 
51010 '* move a memory area ds 
91020 !' ¥en ee nnn errr ll 
51030 '* Input: STARTS% = segment address of the Start area ns 
91040. *-* STARTO% = Offset address of the Start area = 
51050 ** DESTS% = segment address of the destination area ~s 
51060 '* DESTO&% = Offset address of the destination area a2 
51070 '* SIZE% = Number of words to be moved = 
91080 '* DIRECTIONS = Direction in which to move = 
51090 '* data: ns 
3LLOO: 2% 0 = from below 1 MB --> to below 1 MB oie 
51110 '* 1 = from below 1 MB --> beyond 1 MB *S 
51120 '* 2 = from above 1 MB --> below 1 MB ie 
91130) ** 3 = from beyond 1 MB --> beyond 1 MB a 
51140 ** Output: none ne 


51150 CHK HHA KKK KKK KKK KEKE KK KEK KEKE KEK KK KEKEKKRKEKREKEKKKEKKKEKEKEKEKKKKKKKKKKS 


91160 CALL MOVE (STARTS%, STARTO%, DESTS%, DESTO%, SIZE%, DIRECTIONS) 


51170 RETURN ‘back to caller 

51180 ! 

60000 CHK KKK KKK KKK KKKEKAKKERKEKR KKK KKKE KEKE KKKKEKEKKEKEKREKEKKEKKKEKERK 
60010 ‘* initialize the Routine for Interrupt call io 
60020 8 ¥en nnn a nn a nn ee re my 
60030 '* Input: none oe. 


60040 '* Output: IA is the Start address of the Interrupt-Routine cali 


GOO5SD BRAK KAKAAK KKK HK KK KKK KKK KE KKK KKEKKEKKKEEKKEKEKEKEKEKKEKKEKKEEKE 


60060 ! 
60070 IA=60000! ‘Start address of the Routine in the BASIC-segment 
60080 DEF SEG ‘Set BASIC-segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke Routine 
60110 RETURN ‘back to caller 

60120 ' 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138,2 0,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 

60240 ' 
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61000 
61010 
61020 
61030 
61040 
61050 
61060 
61070 
61080 
61090 
61100 
61110 
61120 
61130 
61140 
61150 
61160 
61170 
61180 
61190 
61200 
61210 
61220 


CK KKK KKK KKK KKKKKK KEK KEKE EK KKK KKK KKK KKKKEKKEKKKKKKKKKKKEKEKE 
'* Initialize Routine for moving of mremory areas. lid 
Ie ca Sins cee ‘ened ‘alas Sims eno as dates Sen os ee cece Nas ae ih at es as ae em cee eee elt cack ce nea i es Ss bn vs ta han rw nS cies se a a Sd ce *e 
‘* Input: none xt 
‘* Output: MOVE is the Start address of the Routine = 
CHK HK KKK IKK KIKI KKK KKK KKK KKK KK KKK KKK KAKA KKAKAKKKKKKKAKKKS 
DEF SEG ‘Set BASIC segment 

MOVE=61000! ‘Start address of the Routine 
RESTORE 61130 


FOR I% = 0 TO 140: READ BYTES : POKE MOVE+I%, BYTES : NEXT 

RETURN ‘back to caller 

‘ 

DATA 232,115, 0, O, OO. O. O, O. O, O. O, O, O; O, O 
DATA 0, 0, 0, 0,255,255, 0, O,; 16,146, 0, . 0,255,255, 0 
DATA 0, 0,146, O, O, O, O, O, O, O, O, O, O, OO, O 
DATA 0, O, O, O, O, O, 85,139,236,139,126, 6,138, 45,139 
DATA 126, 12,139, 5,139,126, 10,139, 29,246,197, 1,232, 46, 0 
DATA 136, 84, 28,137 68, 26,139,126, 16,139, 5,139,126, 14,139 
DATA 29,246,197, 2,232, 24, 0,136, 84, 20,137, 68, 18,180,135 
DATA 139,126, 8,139, 13,205, 21,139,229, 93,202, 12, 0, 94,235 
DATA 186,138,212,177, 4,210,234,117, 3,128,202, 16,211,224, 3 
DATA 195,115, 2,254,194,195 


The DATA statements integrated the interrupt call routine and the memory 
movement routine into BASIC. They contain the machine language command 
codes, read and POKEd into the BASIC section starting at address 61000. This 
address is also stored in the MOVE variable so that the program can be called from 
the CALL command in line 51160. For those of you who have mastered assembly 
language, here is the program listing from which the DATA lines of the MOVE 
function were derived. | 


Assembler listing: MOVEBA.ASM 


gp RRR KKK ERK REKEKK KERR KKK KKK ERK KKK KKK KEK KKK KK KEKKKKKKKK KKK KEKE KKK KKK Ke 


code 


=e “se Me Ne Ne Ne Vs 


¢ 

* MOVEBA ; 
is a i a a a a a a es a a es se en ac ae es ee ee eee *s 
7* Task : Makes the functions for moving of xs 
=e memory blocks beyond the 1MB memory limit gs 
ze available in BASIC for linking 7 
: SW aces in ns cs ck Ss Se ns ns sg cau Sin ni Sac as sao a Sc a “assis cs" dc es cas es amc‘ tows ws is es Sint es case as ese sl ges a as 
7x Author : MICHAEL TISCHER rT 
-* developed on : 8.22.87 ee 
ok last Update : 9.21.87 ba 
ex csc in us cms msc min mii us ens i cu mu Gu ine mvews‘mccin sc Gus cma eu cet a ck li’ cee ean’ isan ai ss hn ii iia S's cin Gans em “ans ences tu ei ass ca we 
7% Info: the Code is fully relocatable so that the si 
oe Routine can be poked to any place within the lat 
as BASIC segment ii 
e* ws se cs es emt ces ce ce“ “nn Ss cs ls ee es ces a sa kin sn ss es Ge dee es ce er ew ee ee ee ms 
ed assembly : MASM MOVEBA; pe) 
a LINK MOVEBA; *; 
tae EXE2BIN MOVEBA MOVEBA.COM *; 
FARRER KKK ERK KEK KEKE KKK KKK RE KR REE EKER ERE REE K KKK EEK ERK KKK KEK EKRKEKREKEE » 


segment 


assume cs:code,ds:code,es:code, ss: code 


-- MOVE: Copy storage blocks beyond the 1MB limit -------------------- 
~~ Call from BASIC: CALL ADR(Sourcesegment, StartOffset, Destsegment, 


DestOffset, Size, Direction); 


-- Info : - after the call Variables are in the following 


Positions on the Stack: 
Startsegment = SP + 16 
StartOffset = SP + 14 
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move 


PC System Programming 


Destsegment = SP + 12 


DestOffset = SP + 10 
Size = SP + 8 
Direction = SP + 6 


~ for Direction the following Codes are accepted 
= from below 1 MB --> to below 1 MB 
from below 1 MB --> to over 1 MB 

= from above 1 MB --> to below 1 MB 
= from above 1 MB --> to above 1 MB 
the number concerns words not 

bytes, and can not be larger than 8000 (h) 


i] 


tWHOr © 
! 


proc far 7;GW expects during CALL Far-Procedure 


call get_adr ;the Address of the Routine 


7-- The Global Descriptor Table --------------------- nnn 


GDT 


sa_lo 
sa_hi 


da_lo 
da_hi 


equ this word 


adw 4 dup (?) ;segment Descriptors for Dummy-segment 
dw 4 dup (?) 


segment Descriptors of the Source-Area ----------~----------- 


aw Offffh ;segment length = 64 KB 
dw (2?) ;Lo-Word of the 24 bit-Address 
db 010h ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in memory with 
shighest priority, Writeable 
dw 00000h 7;Compatibility Word for 80386 
segment Descriptors of the Destination-Area --~--------------- 
dw Offffh 7;segment length = 64 KB 
dw (?) ;Lo-Word of the 24 bit-Address 
db (?)} ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in memory with 
zhighest priority, Writeable 
dw 00000h 7;Compatibility Word for 80386 
dw 4 dup (?) ;segment Descriptors BIOS-Code-segment 
dw 4 dup (?) ;segment Descriptors Stack-segment 


y—-~ the Code of the MOVE-Routine ----~------—-—--- <n enn nnn 


movel: 


push bp ;store GW Basepointer 

mov bp,sp 7move SP to BP 

mov di, [bp+6] ;get Address of the direction Variable 
mov ch, [di] ;ymove direction to CH 

mov di, {bp+12] ;get Address of Destsegment-Variable 
mov ax, [{di] ;move destination segment address to AX 
mov di, [bpt+10] 7get address of DestOffset-Variable 

mov bx, [di] ;move destination Offset address to BX 
test ch,1 ;Destination beyond 1 MB? 

call calc_adr ;form 24 bit Address 


mov [sitda hi-gdt],dl ;store result 
mov [sitda_lo-gdt],ax 


mov di, [bp+16] 7get address of the Startsegment-Variable 
mov ax, [di] 7move Source segment address to mov 

mov di, [bp+14] 7get Address of StartOffset-Variable 

mov bx, [di] ;Source Offset address to BX 

test ch, 2 zis Source beyond 1 MB? 

call calc _adr ;form 24 bit Address 


mov [sit+sa_ hi-gdt],dl ;store result 
mov [sitsa_lo-gdt],ax 


mov ah,087h ;Parameter for the Function call 
mov di, [bp+8] 7;get Address of the Size-Variables 
mov cx, [di} 7get number of words 

int 15h 7call RAM-displacement function 


Abacus 7.10 The Cassette Interrupt 


mov sp,bp yrestore Stackpointer 
pop bp sreturn BP from the Stack 
ret 12 sAddresses of the Variables on the Stack 


jare no longer required 


7-- GET ADR: returns the Offset address of the GDT ----------~---~---~- 
77~- Input ; none 

;-~ Output : SI = Offset address of the GDT 

7-- Register : SI is changed 


get_adr proc near 


pop si ;get Address of GDT from Stack 
jmp short movel ;jump to actual Routine 


get_adr endp 


CALC_ADR: calculates the 24 bit (physical) Address -~--~-------~--- 
Input : AX:BX = Buffer address to be converted 
Zero Flag = 1 : Buffer address beyond 1 MB 
-- Output : DL = HI-Byte of Buffer address (bit 16-23) 
-- : BX = Lo-Word of Buffer address (bit 0-15) 
Register : AX, BX, DL, CL and FLAGS are changed 


“=e “Ws “s “Ns Me Re 


calc_adr proc near 


mov dl,ah ;Hi-Byte of the segment address to DL 
mov cl,4 zmove Hi-Nibble of the segment 
shr dl,cl ;address to the Lo-Nibble 


jne under imb ;test if beyond 1 MB 


or d1,010h zis beyond 1 MB 


under Imb:shl ax,cl ;segment address times 16 
add ax,bx ;add Offset address 
jnc no more ;test if excess 
inc dl 7yes 

no _ more: ret ;back to caller 


calc adr endp 


The INLINE command, not DATA statements, integrate the MOVE routine into 
the following Pascal program. 


Pascal listing: MOVEP.PAS 


{ BA RII KKK RIK IKK RRR KRHA IK IKK KHAKI KEK ARI KHAKAKKREKERHREER | 


(* MOVEP *} 
{* a es as ae ae cs a ew ee ee ee ee er ee nee ee ee SO SS As OP eM ee ans ve rcs SD co Se be SNP Sn SEU DD OU He ae Sc ee aoe ane ae mn *} 
t Task : With the help of a procedure, Data are a 
ce copied in RAM below and above 1 MB * 
{* ne ee a ec ce ce ae se en sa ee ee en see ce cies Oe enn wes en en Om ae ene cn cs ue ene Se ee me ee uD ens nD aD Sn ee me se SE OND Ane SH Ss ee es en ae se em ce *} 
t* Author : MICHAEL TISCHER a 
{* developed on : 8/8/87 ot 
{* last Update : 6/8/89 *} 
{* te a sore eee ee cee ent era cae cnn ep etn a SE Sap mE SON ene ms SS SD END nn DD DD A aS ND ED KD DY NY SED SED ED NY SD ED DMD GERD SND CN SEED en ty AON ERD aD came *} 
1 Info : This program runs only on ATs and *} 
{* only if RAM beyond 1 MB id) 


345 


7. The BIOS PC System Programming 


{* is available *} 


{ RRMA KKK RRR KER KK EKER KKK KKK KER EREKEEKEKEKREKHKKEKEK EE | 


program MOVEP; 


Uses Crt, Dos; {add Crt and Dos units} 


var Keypress : char; 


{FAH IR KIKI HRI HK IKK KIKI EK IKARIA K KEKE KEKE KKKEKEK KEK | 
{* GETPAGE: returns the segment address of the current display page *} 
{* Input : none *} 
{* Output : the segment address of the current display page *} 


{RRR RHI HR RIKKI IRR RRR KKK RIKI KEKE KEKE RE KK IKK KEK | 


function GetPage : Longint; 


var Regs : Registers; {Processor registers for interrupt calls} 
begin 
Regs.ah := 15; - { Function number } 
intr($10, Regs); { Call BIOS video interrupt } 
if Regs.al = 7 then GetPage := $B000 { Monochrome card } 
else GetPage := $B800; { Color card } 
end; 


{BERR REE EERE EEK RRR ERE RE RE KK RE KEK ERERREKEKEKREKKEKREKKKEKEKEREKKKEEKEEE | 


{* MOVE: moves memory areas i 
{* Input : see below *} 
{* Output : none *} 
{* Info: Direction: 0 = from below 1 MB--> to below 1 MB *} 
{* 1 = from below 1 MB--> to above 1 MB *} 
is 2 = from above 1 MB--> to below 1 MB *} 
{* 3 = from above 1 MB--> to above 1 MB, *} 
i* Addresses above the 1MB boundary are given relative *} 
{* to this value a 


[AIR RI THI HR RR RRR IIHR IKK RIK KKK RIKER KE KERR EER KEKE KKK EKKEKRE KE | 


{SF+} 
procedure HiMove (StartSeg, { Segment address of the start buffer } 
StartOfs, { Offset address of the start buffer } 
Dest Seg, { Segment address of destination buffer } 
DestOfs, { Offset address of destination buffer } 
Size, { Number of words to be copied } 
Direction : integer); { Direction in which to copy } 
begin 
inline ( 
$8B/S7E/$10/S8B/$76/S0E/$8B/$46/S0C/S8E/$C0/$8B/$S5E/S0A/ 
$8B/$46/S08/S$8B/S4E/$06/$8A/SE9/$55/$E8/$5E/$00/$00/$00/ 
$00/$00/$00/$00/$00/S00/$00/$00/$00/$00/$00/$00/$00/$00/ 
SFF/SFF/$00/$00/$10/$92/$00/$00/SFF/SFEF/$00/$00/$00/$92/ 
$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/$00/ 
$00/$00/$00/$00/$50/S$8C/$C0/SF6/$C5/$01/$E8/$28/$00/$2E/ 
$88/$56/$1C/$2E/$89/$46/$1A/$8B/$C7/$8B/SDE/SF6/$C5/$02/ 
SE8/$16/S00/$2E/$88/$56/$14/$2E/$89/$46/$12/$B4/$87/S0E/ 
$07/$59/$8B/SFS/S$CD/$15/S$EB/$17/$5D/SEB/SCF/$8A/$D4/$B1/ 
$04/$D2/SEA/$75/$03/$80/$CA/$10/$D3/$E0/$03/$C3/$73/$02/ 
SFE/$C2/$C3/$5D 
); 
end; 


{RA RRR IR IK IK KIRK K EHR ERE RK AKER AKER RRR KAKA EKEREKEKKK EE | 


{* MAIN PROGRAM *) 


{KX AKAHK AKER HK HER KK KKK KK AKER KEI KKKKEKKKKKEKKEKKKKAKKKKKKK EK } 


begin 
clrscr; { Clear Screen } 
writeln(*MOVEP (c) 1987 by Michael Tischer'); 
writeln (#13#10'This Program uses Function 87({h) of ‘+ 
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‘Interrupt 15(h) to move blocks of storage '); 
writeln ('between the “normal™ RAM and the RAM beyond the 1 Mega-‘'+ 
‘Byte storage boundary'); 
if mem(SFOOO:SFFFE] <> SFC then { test if computer is an AT } 
begin 
writeln('Since this computer is not an AT, '+ 
‘but a PC or'); 
writeln('an XT, and these can not have storage '+ 
‘beyond the 1 MB boundary, '); 
writeln('this program can not execute on your PC! '); 
writeln('Sorry....'); 
end 
else 
beg in 
writeln('First this display page is moved immediately ‘+ 
‘beyond the 1 MB storage '); 
writeln('boundary. The screen is then cleared. ‘+ 
‘After a key has been activated, ‘'); 
writeln (‘the old display page is restored.'); 
writeln(''#13#10'Please activate a key now to ‘+ 
‘start the program...'); 


repeat until keypressed; { Wait for a key } 
Keypress := ReadKey; { Read key } 
HiMove (Get Page, $0000, $0000, $0000, $2000,$1); { Copy video RAM } 
clrscr; { Clear screen } 
writeln('Please press a key ...'); 
Keypress:= ReadKey; { Read key } 
HiMove ($0000, $0000, Get Page, $0000,$2000,$2); { Restore video RAM } 
gotoxy (1,15); 
writeln('That*s All!'); 
end; 


end. 


For the Pascal programmers interested in assembly language, the assembler listing 
of the MOVE function appears here. 


Assembler listing; MOVEPA.ASM 


RRA KKK KKH KKK HERRERA KKK KKK RARER RARER AKKEKHEKKK KK 0 


¢ 
:* MOVEPA *; 
hs ses mis ems Cus rte’ es lies cues crocs ein: es casas cans as cms cess as abs as ems Siu aes Ss cs eld “Gees co ceases Geo Gets ‘snus ecsb sao Geass elo ccs as sca sas eos is Gs cnn is ma es ie ens sin teaser as i ces ease ts as 
-* Task : copies Data between the RAM below 1 MB and oe 
:* above 1 MB te 
ul CAUTION! This is the Version for linking “s 
:* in a Pascal Program with INLINE- x; 
bea commands ns 
x sais ens ks i ei eco cnn aes ss cm a cm aaa toss el Sess San ss ses cers‘ ces Sus cul rte Ss Se cai nin abs cs 'caus mn cess smo svn eye nik sui as mc ues assent tus nim evs ste xs 
rial Author : MICHAEL TISCHER *s 
rel developed on : 6.8.87 * 3 
> last Update : 6.8.89 ae 
ae ini si he Ss is ei li a el gc ts ci ie’ on ee wc se i as a gs sls ev ot St es is ts vs el es cs re ce ee el tum me el lil Sa has em ei it el *s 
;* assembly : MASM MOVEPA; *s 
es LINK MOVEPA; ts 
iiss convert to INLINEs and add to Turbo Pascal *s 
7 RA KRRKKRERKRKKEREREKEKRIERREKEEKKAKKREKEKEREREEKEKEREEEKREEEREKEKREEKREEKKKKKE 0 


code segment para ‘CODE' ;Definition of the CODE-segment 


org 100h zit begins at Address 100 (h) 
;directly behind the PSP 


assume cs:code, ds:code, eS:code, ss:code 


;-~Call: HiMoves(StartSeg, 
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“se “5s “se Re Ne Ws 


StartOfs, 

DestSeg, 

DestOfs, 

NumWords, 
Direction : word); 


This routine is designed as a FAR call model 


movepa proc near 
sframe struc ;Access structure on stack 
bptr dw ? ;Taken by BP 
ret_adr dd ? ;Return address (FAR) 
directn dw ? ;Copy direction 
numwords dw ? ;Number of Words being copied 
destofs dw ? ;Destination buffer's offset address 
destseg dw ? ;Destination buffer's segment address 
startofs dw ? 7Starting buffer's offset address 
startseg dw ? ;Starting buffer's segment address 
sframe ends ;End of structure 
frame equ [ bp - bptr ] ;For stack addressing 
push bp ;Store BP on the Stack 
mov bp,sp 7Move SP to BP 
mov di,frame.startseg ;Get source segment from stack 
mov si, frame.startofs ;Get source offset from stack 
mov ax,frame.destseg ;Get destination segment from stack 
mov eS,ax yand move to ES 
mov bx,frame.destseg ;Get destination offset from stack 
mov ax, frame.numwords ;Get numwords from stack 
mov cx,frame.directn ;Get direction from stack 
mov ch,cl y;and send to CH 
push bp 7Mark BP 
call getgdt ;Determine address of GDT 
j-~ Variables and Data of the MOVE-Function --------------------------- 
GDT equ this word 


;7- THIS IS THE GDT (GLOBAL DESCRIPTOR TABLE) --------------------- 


sa_lo 
sa_hi 


da_lo 
da_ hi 


dw 4 dup (?) ;segment Desc. for Dummy-segment 

;-~- this segment Descriptor describes the GDT itself -------- 
dw 4 dup (?) 

7-- segment Descriptor of the Source-Area ------------------- 


dw Offffh 7segment length = 64 KB 

dw (?) ;Lo-Word of the 24 bit-Address 
db 010h ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in storage with 

zhighest Priority, Writeable 

dw 00000h 7Compatibility Word for 80386 
7-- segment Descriptor of the Destination-Area -------------- 
dw Offffh 7segment length = 64 KB 

dw (?) ;Lo-Word of the 24 bit-Address 
db (?) ;Hi-Byte of the 24 bit-Address 
db 10010010b . gData segment in storage with 

rhighest Priority, Writeable 
dw 00000h ;Compatibility Word for 80386 


;-- this segment Descriptor describes the BIOS-Code-segment 
dw 4 dup (?) 


;-- this segment Descriptor describes the Stacksegment ------ 
dw 4 dup (?) 
77- END OF THE GDT --9- n-ne nnn rr rrr rr rrr rrr rn 


Moves Data between memory above and below 1 MB -------------- 
: DI:SI = Source address (if above 1 MB as Offset to 1 MB) 
= Dest. address (if above 1 MB as Offset to 1 MB) 
CH = move ... from --> to 
00b = from below 1 MB --> to below 1 MB 
Olb = from below 1 MB --> to above 1 MB 


Abacus 7.10 The Cassette Interrupt 


-— 10b = from above 1 MB -=-> to below 1 MB 

-- lib = from above 1 MB <--> to above 1 MB 

-_— AX = Number of words to be moved (max. 08000h) 

Output : Carry-Flag = 1: Error 

-- Register : AX, BX, DL, CL, SI, ES and FLAG are changed 

Info : This function should not be used to move RAM below the 
1-MB boundary 


™e Se Me Me Me Ne Me 
I 
j 


move: push ax ;Store number of words on the Stack 
mov ax,es ;Destination segment address to AX 
test ch,1 zis destination above 1 MB? 
call cale adr ;form 24 bit Address 


mov cs: ([bp+28],dl ;store result 
mov cs: [bpt+26], ax 


mov ax,di ;Source segment address to AX 
mov bx,si 7;Source Offset address to BX 
test ch,2 zis Source above 1 MB? 

call calc _adr - -form 24 bit Address 


mov cs: [bpt20],dl ;store result 
mov cs: [bpt+18],ax 


mov ah,087h ;load Parameter for function call 
push cs 

pop es 7set ES to CS 

pop cx 7;Get number of Words from Stack 
mov si,bp ;load Offset address of GDT 

int 15h ;Ccall RAM moving function 

jmp short ende ;back to Turbo 


movepa endp 


GETGDT: Get Address of the GDT and jump to MOVE -~--------~--------- 
Input : none 

Output : CS:BP = Address of the GDT 

Register : only BP is changed 

Info : this Routine can only be used in the environment 

-- of this Program 


=e “es Ss “Me Be Ve 
! 
i 


getgadt proc near 


pop bp ;Get Address of GDT from the Stack 
jmp short move ;Jump to MOVE-Routine 


getgdt endp 


-~ CALC ADR: calculates 24 bit (physical) Address -------~------------- 
Input : AX:BX = Buffer address to be converted 

—_ Zero Flag = 1: Buffer address beyond 1 MB 

~- Output : DL = HI-Byte of the Buffer address (bit 16-23) 

-- : BX = Lo~-Word of the Buffer address (bit 0-15) 

~- Register : AX, BX, DL, CL and FLAGS are changed 


wa Ns Nea Ss Ne Ne 


calc_adr proc near 


mov dl,ah ;Hi-Byte of segment address to DL 
mov cl,4 ;shift Hi-Nibble of segment 
shr dl,cl ;address into Lo-Nibble 


jJne under lmb ;test if above 1 MB 


or d1,010h zis above 1 MB 


under _imb:shl ax,cl ;segment address times 16 
add ax,bx ;add Offset address to it 
jnc no _more stest if overflow 
inc dl yes 

no_more: ret rback to caller 


calc_adr endp 
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ende label near 7Code stops here 
pop bp 7Restore BP from atack 
code ends zEnd of the CODE segment 
end movepa 7End of the assembler program 


The C program differs from the BASIC and Pascal programs in that the MOVE 
function is also present as an assembler routine, but excluded from the C program 
listing. First the MOVE assembler program assembles, then the C program is 
compiled. You then merge the two programs using the linker. For this reason the 
listing of the C program follows with the source listing of the corresponding 
assembler function. 


C listing: MOVEC.C 
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[RRR RK KEKE KKK KEKE KEK KKK EHH K KEKE K KKK KKK EKER KEKE EEK IK / 


/* MOVEC it f 
JR ai i a at a eee ts ea a es */ 
/* Task: integrates an Assembler-Routine in C, which can x7 
/* move memory blocks beyond the 1 MB boundary */ 
Dee RRO ID ne Reef Oe Oe EN EN CSN cee ee Ne ON ONO Tie eee ee Ee */ 
{* Author : MICHAEL TISCHER | */ 
/* developed on : 8.13.87 */ 
/* last Update : 9.21.87 i § 
[ Bann ao a ae ee ee a cr ae a ee */ 
/* (MICROSOFT C) i 
/* Creation : MSC MOVEC; Fd 
/* LINK MOVEC MOVECA PEPO; */ 
/* Call : MOVEC at & 
[ Bmw rr en rn nn rn nn nnn at A 
{* (BORLAND TURBO C) */ 
/* Creation: with Project-File with the following content: */ 
/* movec */ 
/* moveca.obj df 


[RR KKKKKERKRKKKRERK KKK RK KERIKERI KIER IKI KK IKK AIK AKAIKE IKKE AKER RIERE AK / 


#include <dos.h> /* include Header-Files */ 
#include <io.h> 
#include <conio.h> 


extern void AdMove (); /* ADMOVE must be linked */ 
extern int PeekB(); /* PEEKB must be linked */ 
[RRR RIK IKK IKI III II KIKI AAAI IAA AKA AAAI AKI AKA IAI KIKI KA KE 
/* GETPAGE; returns the Address of the current display page a]. 
/* Input : none */ 
/* Output : see below */ 


[RR RRK RIE RIKERRRKIK I KR IRKKKKKIKRKIK ERR IKKE KIRKE KEK EEK IKE KK KR KER REE EK / 
unsigned int GetPAge () 


{ 


union REGS Register; /* Register-Variable for Interrupt call */ 
Register.h.ah = 15; /* Function number to get Video parameter */ 
int86(0x10, &Register, &Register); /* Call Interrupt 10(h) */ 


return ((Register.h.al == 7) ? OxBO0O : O0xB800); 
} 


[RR RREKEIIK ARR IHRK RK KREIS RIKKI IAI IK IKI KI ARI RIE IRI AAI IIA IAA IAAI AK | 
/* CLS : Clear Screen xf 
/* Input : none */ 
/* Output : none iat § 


Abacus 7.10 The Cassette Interrupt 


[RRA IKKEKE KERRIER KKK KKK KK REK IKKE AKER AEE ERIKE / 


void Cls() 

{ 

union REGS Register; /* Register-Variable for Interrupt call */ 
Register.h.ah = 6; /* Function number for Scroll-UP */ 
Register.h.al = 0; /* 0 is for clear */ 
Register.h.bh = 7; /* white characters on black background */ 
Register.x.cx = 0; /* upper left display corner */ 
Register.h.dh = 24; /* Coordinates of the lower */ 
Register.h.dl = 79; /* right display corner */ 
int&6(Oxi0, &Register, &Register); /* Call BIOS-Video-Interrupt */ 


} 


[LEKI IIH IKI IKE KIRK KIKI IK IKEA KEKE KIKI KEK IKK KHAKI KE / 


[e* MAIN PROGRAM lel 


[RRR IKK HIKER IKK IKK KKK I IK III IIE AIK IK KIKI KEKE KKKRKK EE / 
void main () 


{ 
printf ("\nMOVE (c) 1987 by Michael Tischer\n\n"); 
printf ("This Program uses the Function 87(h) of Interrupt 15 (h)"); 
printf (" to move memory blocks\nbetween the \"normal\" RAM and the "); 
printf ("RAM beyond the 1 Mega-Byte storage limit.\n"); 
if (PeekB(OxFO00, OxFFFE) != OxFC) /* test if AT */ 
{ 
printf ("Since this PC is not an AT, but a "); 
printf ("PC or XT\nand this PC can not have RAM "); 
printf ("beyond the 1 MB storage limit, "); 
printf ("this program can not be executed! Sorrv...\n\n"); 
} 
else 
{ 
printf (“After starting the program by pressing a key "); 
printf ("the current display\n content is "); 
printf (“copied directly beyond the 1 MB-limit\n "); 
printf ("and then the display is cleared. If another key is "); 
printf ("\npressed ,the old display is again "); 
printf (“restored.\n\nPlease press a key to "); 
printf ("start the Program ..."); 
getch (); /* wait for a key */ 


/*-- Copy current Video Rrm beyond 1 MB ---------~----------------— */ 
AdMove (Get Page (}, 0x0000, 0x0000, Ox0000, 0x2000, 1); 


Cls(); /* Clear Screen */ 

printf ("\nPlease press a key ..."); 

getch(); /* get a key */ 
4 

/*-- Restore Video-RAM -~-~- 92 n nnn rn rrr rrr rrr */ 


AdMove (0x0000, 0x0000, GetPage(), Ox0000, Ox2000, 2); 
printf ("\n\nThat's It!\n"); 


Assembler listing: MOVECA.ASM 


’ 


FOR TOT IR TTI IIT IKI FI KK ITOK II TI TTR IIIA IATA AIS IA IAAI AA AIA IIIA IIA IAAI IAI AK 0 , 
id MOVECA *? 


+ 
! 
! 
! 
! 
| 
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J 
! 
J 
| 
t 
| 
| 
I 
! 
| 
[ 
! 
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! 
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! 
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! 
! 
I 
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I 
! 
! 
J 
! 
I 
* 


+ Ne 
=a 


Task : Makes the Functions for moving of 
Storage blocks beyond the 1MB memory limit 
available for inclusion in C 


Author : MICHAEL TISCHER 


+ 
+ 


"=e Sa “Msp Me Me Ne Na Ne 
+ 4 
* 


* 
~e Me Me Ne 


+ 
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;* developed on : 8.13.87 “; 
[= last Update : 9.21.87 Ks 
© FE ce ek a ena es sees ees ens een “ew eats Geom dca Ges in ses sets ‘nies abs icin sans Wish <a wk ‘ans cs ‘ita ween Ge ess cake is Wao ies lah ce hs sn ts Wats leis Cctan oe Cass sain cents ees cea bh eas ih tesCais ce td im tes iis nth aus itn ooo ke 
v A 
;* assembly : MASM MOVECA; a? 
PUA RHERKEKEKHKKKRAKKER RHR KH IK IK IRI HK KIKI REAR KEKE EERK KEKE ER KEEEREKREKEK © 


IGROUP group text ;Grouping of Program~-segments 
DGROUP group const, bss, data ;Grouping of Data-segments 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


public AdMove ;Functions become accessible to other 
; programs 


CONST segment word public 'CONST' ;this segment accepts all 


CONST ends ;readable Constants 
_BSS segment word public ‘'BSS' ;this segment accepts not all 
_BSS ends rinitialized static Variables 


_DATA segment word public 'DATA' yall initialized global and 
;static Variables are stored in this 


, segment 
GDT equ this word ;the Global Descriptor Table 
dw 4 dup (?) ;segment Desc. for Dummy-segment 
dw 4 dup (?) 
7~~- segment Descriptors of the Source-Area --------------------- 
dw Offffh ;segment length = 64 KB 
sa_lo dw (?) ;Lo-Word of the 24 bit-Address 
sa_ hi db 010h ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in storage with 
shighest Priority, Writeable 
dw 00000h ;Compatibility word for 80386 
7-- segment Descriptors of the Destination-Area ----------------- 
dw Offffh ;segment length = 64 KB 
da_lo dw (?) ;Lo-Word of the 24-bit-Address 
da_ hi db (?) ;Hi-Byte of the 24-bit-Address 
db 10010010b ;Data segment in storage with 
;highest Priority, Writeable 
dw 00000h ;Compatibility word for 80386 
dw 4 dup (?) ;segment Desc. BIOS-Code-segment 
dw 4 dup (?) ;segment Descriptors Stack-segment 


_DATA ends 
_TEXT segment byte public 'CODE' ;the Program segment 


;- ADMOVE: Copy Storage Blocks beyond the 1MB limit ------------------- 
- Call of C: AdMove(Startsegment, StartOffset, Destsegment, 
DestOffset, Size, Direction); 

-- Info : - for DIRECTION the following Codes are accepted: 
O = from below 1 MB --> to below 1 MB 

1 = from below 1 MB --> to above 1 MB 
sara 2 from above 1 MB --> to below 1 MB 
a 3 = from above 1 MB <--> to above 1 MB 
=e - the number relates to words, not Bytes 
sae and can not be larger than 8000 (h) 

a ~ for moving of RAM below the 1-MB border 
= the Functions MOVEDATA or MEMCPY should 


I 
( 


i 


ma Be Be Be Me Re Ve Ve We We Ne We 


“— be called 
_AdMove proc near 
push bp ;store BP on the Stack 
mov bp, sp ;move SP to BP 
push si 7;C expects unchanged SI 


Abacus 


mov 
mov 
mov 


test 
call 


mov 
mov 
mov 
mov 


test 
call 


mov 
mov 
mov 


push 


pop 
mov 
MOV 
int 


pop 
mov 


pop 
ret 


_AdMove endp 


ch, [bp+14] 
ax, [bp+8] 
bx, [bp+10] 
chy 1 

calc adr 
da_hi,dl 
da_lo,ax 
ax, [bp+4] 
bx, [bp+6]} 
ch,2 

calc adr 
sa_hi,dl 
sa lo,ax 
ah, 087h 
ds 

es 


ex, [bpt+12] 


si,offset DGROUP:GDT 
15h 


si 
sp, bp 
bp 


7.10 The Cassette Interrupt 


smove Direction to CH 

sDestination segment address to AX 
7Destination Offset address to BX 
zis Destination beyond 1 MB? 

;form 24 bit Address 

ystore result 


7;Source segment address to AX 
;Source Offset address to BX 
sis Source beyond 1 MB? 

;form 24 bit Address 

sstore result 


7Parameter for the Function call 
j load 

;st ES to DS 

7get number of Words 

sload Offset address of GDT 
7Call RAM moving functions 


;restore old SI from Stack 
;restore Stackpointer 

7get BP from Stack 

;Return to calling C-Program 


-- CALC_ADR: calculates 24 bit (physical) Address ~------------------- 
-- Input : AX:BX = Buffer address to be converted 

Zero Flag = 1: Buffer address beyond 1 MB 

DL = HI-Byte of the Buffer address (bit 16-23) 

BX = Lo-Word of the Buffer address (bit 0-15) 

AX, BX, DL, CL and FLAGS are changed 


-- Output : 


7~- Register 


calc_adr proc near 


mov 
mov 
shr 
jne 


or 
under _1mb:shl 
add 
jnc 


inc 


no more: ret 


calc adr endp 


_text ends 
end 


dl,ah 
cl1,4 
dl,cl 
under imb 


d1,010h 
ax,cl 
ax, bx 


no_more 


dl 


;Hi-Byte of segment address to DL 
z7move Hi~Nibble of segment address 
zinto the Lo-Nibble 
;test if beyond 1 MB 


z7beyond 1 MB 

;segment address times 16 
sadd Offset address 

jtest if overflow 


7yes 


sback to caller 


7;End of the Program-segment 
7;End of the Assembler-Source 
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Here is the assembler program. No additional program code is required for 
integrating the MOVE function because it is built-in. 


Assembler listing: MOVEA.ASM 


: KH KKK KEKE KKK KKK KEK KEKE KKK KKK KEK KKK KKK KR ERK EKER KE KEKE KKK KEKE KK KEEKKEKEKE KK 0 
o* MOVEA ba 
; FE ncn is c's ces i si i os tes eno sais sentient sine" i'n ain iin ms cin an ens i Samus i nm Sac i! em i’ nk si a eins in mS Sela esses x 
os Task : coples data between RAM below 1 MB and bts 
7 above 1 MB =e 
: I ns seed aa ta ee ink ea tea nb es oes So tn Gm aos sn on cs co Sas ce eek ase a es es eS a Ss ees Gs es se Sa ee ee ae ee ee ae ball 
ae Author : MICHAEL TISCHER grt 
;* developed on : 6.8.87 =; 
;* last Update : 9.21.87 *s 
: GE as ct a es na cs win aes coe ee ea as en as es a ee ses ass ae eco a es i es ces oe ws wo es a ee we cn a tes es sw we a * > 
x assembly : MASM MOVEA; *? 
;* LINK MOVEA; > 
=x EXE2BIN MOVEA MOVEA.COM ™ 
: SI sistas ese sa ce ise ip ten iS il te i St i Se a cae ct ea ee ee Sa one ee ce ee ee ee * , 
;* Call : MOVEA a; 
: KHKKKK KKK KEKE KKK KKK KKK KKK KKK KKK KKK KKK KKK KEK KKKE KKK KEK KKK KKK KKEKKEKKKKE EK 9 
bios segment at OF0O00h ;used for Addressing of the 
7Device-Codes 
org OFFFEh ;Address of the Device-Codes in BIOS 
gercode equ this byte 
bios ends 7End of the BIOS-segments 
code segment para ‘CODE' ;Definition of the CODE-segment 
org 100h zit begins at Address 100 (h) 
;directly after the PSP 
assume cs:code, ds:code, es:bios, ss:code 
movea proc near 
;-- Output Initiation Message ----------------------------------— 
mov dx,offset initm ;Offset address of the Init message 
mov ah,9 soutput Function number for String 
int 2ih 7;Call DOS-Interrupt 
mov ax, OF0O00h ;segment address of BIOS 
mov eS,ax ;to ES 
cmp es:gercode,0OFCh zis the device an AT 
je isat 7;YES --> continue to execute Program 
;-- Device is PC or XT, Program doesn't run --------9------------ 
mov dx,offset sorrym 7;Offset address of Text 
jmp short pcext ;Output message and terminate program 


;-- User must activate a key to start the program 


isat: mov dx,offset dom ;Offset address of the Text 
mov ah, 9 youtput function number for String 
int 21h ;call DOS-Interrupt 
xor ah,ah ;read a character from the keyboard 
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int 16h 7call BIOS—Keyboard-Interrupt 

z-- Move Video~-RAM to 1 MB ww- one rrr rrr rrr 
call getvseg 7;Get segment address of Video-RAM 
mov di,ax zand move to DI 

xor si,si scopy starting at Offset address 0 
xor bx,bx ;copy after 1MB + 0000:0000 

mov es,bx 

mov ch,1 ;from below 1 MB to above 1 MB 
mov ax, 2000 ;move 2000 

call move :Words 

4c fehler yon error terminate 


7-~ Fill Video-RAM with characters --~----------------------- 


call 
MOV 
xor 
mov 
Mov 
rep 


pext: mov 
int 
mov 
int 

movea endp 

7—-— GETVSEG 


77—~ Input : 
7-—- Output : 
7-~ Register : 
getvseg proc 
mov 
int 
cmp 


jne 


mov 
ret 


colvideo: mov 


getvseg 
es, ax 
di,di 
cx, 2000 
ax, 87FEh 
stosw 


7;Get segment address of the Video-RAM 
j;and move to ES 

;start at Offset address 0 

;f111 the complete Video-RAM with 
7blinking Block-Character 


User must activate a key -------- 3 rrr rrr 


dx,offset userm ;Offset address of the Text 


ah, 9 
21h 


ah, ah 
16h 


7output function number for String 
7call DOS-Interrupt 


;read a character from the keyboard 
7call BIOS-Keyboard-Interrupt 


Restore Video-RAM again ~--------- 3 rn 


di, di 
si,si 
bx, bx 
ch, 10b 
ax, 2000 
move 
fehler 


ax, 4C00h 
21h 


dx,offset errm 
ah, 9 
21h 
ax, 4COlh 
21h 


;restore 1 MB + 0000:0000 


7from beyond 1 MB to below 1 MB 
;move 2000 

;Words 

;terminate on error 


7terminate Program with call of a DOS 
;function on return of Error-Code 0 


7Offset address of error message 
7output function number for String 
7call DOS-Interrupt 

;terminate Program with call of a DOS 
7function on return of Error-Code 1 


returns the segment address of the Video-RAM - 


none 


AX = segment address of the Video-RAM 
AX, BH and FLAGS are changed 


near 


ah, OFH 
10h 

al,7 
colvideo 


ax, OB0O00h 


ax, OB800h 


7get function number for Video 
7call BIOS-Video-Interrupt 

zis a Mono-Card installed? 

;NO --> Color-Card 


;segment addr. of the mono Video-RAM 
sback to caller 


;segment addr. of color Video-RAM 
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ret ;back to caller 
getvseg  endp 


7-~ MOVE: Moves Data between Storage above and below 1 MB - 
7-~- Input : DI:SI = Sourceaddress (if above 1 MB as Offset to 1 MB) 
-~ ES:BX = Dest address (if above 1 MB as Offset to 1 MB) 
-- CH move ... from --> to 

-— 00b = from below 1 MB --> to below 1 MB 
—= Oilb = from below 1 MB --> to above 1 MB 
-— 10b = from above 1 MB --> to below 1 MB 
~— 1lb = from above 1 MB -=-> to above 1 MB 
AX = Number of words to be moved (max. 08000h) 

-- Output : Carry-Flag = 1 : Error 

~- Register : AX, BX, DL, CL, SI, ES and FLAG are changed 
-- Info : this function should not be used for moving 
from RAM below the 1 MB limit 


! 
| 


=:3 “Ss Ss “Ne Rs Re Ve Ve We Ve Ve 


move proc near 
push ax s;record number of Words on the Stack 
mov ax,es ;Destination segment address to AX 
test ch,1l zis Destination above 1 MB? 
call calc _adr ;form 24 bit Address 
mov da_hi,dl ;store result 
mov da lo,ax 
mov ax,di ;Source segment address to AX 
mov bx,si ;Source Offset address to BX 
test ch, 2 zis Source above 1 MB? 
call calc adr ;form 24 bit Address 
mov sa_hi,dl ;store result 
mov sa_lo,ax 
mov ah,087h ;Parameter for the Function call 
push ds ; load 
pop es ;set ES to DS 
pop cx ;read number of Words from Stack 
mov si,offset GDT ;load Offset address of GDT 
int 15h scall RAM move function 
ret ;back to caller 


7;-- Variables and Data of the MOVE-Function ----------~--~--------------- 
GDT equ this word 


;-- THIS IS THE GDT (GLOBAL DESCRIPTOR TABLE) ------~--~------- 
dw 4 dup (?) ;segment Descs. for Dummy-segment 
7-~ this segment Descriptor describes the GDT itself -------- 
GQw 4 dup (?) 


7~~- segment Descriptor of the Source-Area ------------------- 
dw Offffh 7;segment length = 64 KB 
sa_lo Gw (?) ;Lo-Word of the 24 bit-Address 
sa_hi db 010h ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in storage with 
zhighest Priority, Writeable 
dw 00000h 7;Compatibility Word for 80386 
;~- segment Descriptor of the Destination-Area -------------- 
dw Offffh 7segment length = 64 KB 
da_lo dw (?) ;Lo-Word of the 24 bit-Address 
da_hi db (?} ;Hi-Byte of the 24 bit-Address 
db 10010010b ;Data segment in storage with 
;highest Priority, Writeable 
dw 00000h ;Compatibility Word for 80386 


7-- this segment Descriptor describes the BIOS-Code-segment 
dw 4 dup (?) 


7-- this segment Descriptor describes the Stack segment -~--- 
GQw 4 dup (?) 
7-- END OF THE GDT -------------~---------------------------- 


move endp 
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; calculates 24 bit (physical) Address ------------------- 
; AX:BX = Buffer address to be converted 
= zero Flag = 1: Buffer address above 1 MB 


: 


-- Output : DL = HI-Byte of the Buffer address (bit 16-23) 
ie : BX = Lo-Word of the Buffer address (bit 0-15) 
: AX, BX, DL, CL and FLAGS are changed 


calc_adr proc near 


mov dl,ah ;Hi-Byte of the segment address to DL 
mov cl,4 ;Hi-Nibble of the segment address 
shr dl,cl ;shifted to Lo-Nibble 
She. -under “ime stest if above 1 MB 
or d1,010h z;lies above 1 MB 
under 1lmb:shl ax,cl 7segment address times 16 
add ax,bx zadd Offset address 
jnc no more ;test for overflow 
inc dl ;yes 
no_ more; ret ;back to caller 


calc adr endp 


initm db 13,10,"MOVE (c) 1987 by Michael Tischer",13,10,13,10 
db "This Program uses the Function 87(h) of Interrupt “ 
db "15(h) to copy memory blocks",13,10,"between ‘normal‘' " 
db "RAM and RAM above the 1-Megabyte boundary".",13,10,"$" 
dom db "The Program copies first the current display " 
db “content directly",13,10,"after the 1-MB-boundary and " 
db “the fills the screen with characters.",13,10 
db “After a key has been activated, the old " 
db “display content ",13,10,"is restored and the Pro" 
db “gram terminated.",13,10,"Please press a key, to " 
db “start the Program ...$" 
sorrym db "Since this computer is not an AT, " 
db “but a PC or",13,10,"XT, and these " 
db “PCs can not have storage beyond the 1-MB limit," 
db 13,10,"“this program can not be started! " 
db “Sorry...",13,10,"$" 
userm db 13,10," Please press a " 
db "key s" 
errm db “WARNING ! Error on access to RAM above 1 MB" 
db 13,10,"$" 
’ == End See are Se See oe a aS SE Sa SSeS Se Se Se See Ss Se Se Se a Sea Se ae Sa SG AS SS SL SE STO OSS SONS DENTS SADE SCT ENS SUR SOE SE SOE SOON SO SOE SS OS SS Se Se Se ae ee a a a Sa So 
code ends 7End of the CODE-segment 
end movea ;End of the Assembler-Program,. 
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7.11 Accessing the Keyboard from the BIOS 


Interrupt 16H provides three functions to read the keyboard and keyboard status. 
The BIOS keyboard functions are very limited: No BIOS functions exist for 
removing characters from the keyboard buffer or renaming keys. DOS functions 
can perform these operations. 


BIOS-proof keys 


Some key combinations cannot be read by BIOS as key codes because they execute 
commands. Activating the <PrtSc> or <Print> key calls BIOS interrupt 5H. This 
Starts a routine which sends the current screen display to a printer, producing a 
hardcopy. 


The <Ctrl><Num Lock> keys stop the complete system until the user presses 
another key. The keyboard buffer ignores the <Ctrl><Num Lock> keys and the 
subsequently pressed key, so programs cannot read these keys. 


Pressing the <Ctrl><Break> key combination calls interrupt 1BH. Normally the 
Current program stops and returns to DOS. To prevent this, this interrupt can be 
directed to a routine within the application program which continues program 
execution if the routine consists of an IRET assembly language instruction only. 


ATs and a few advanced PC/XTs have the <Sys Req> key. Its activation calls 
interrupt 15H by passing the value 8500H to the AX register. When the user 
releases the key, the AX register then receives the value 8501H. The value 85H in 
the AH register represents the function number of interrupt 15H. After starting the 
system, function 85H of the BIOS interrupt 15H consists only of an IRET 
instruction; pressing the <Sys Req> key has no visible result. 


Control codes 
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Most people know that any ASCII code can be entered from the keyboard using the 
<Alt> key and the keys of the numeric keypad. Few users know about character 
entry with the help of the <Ctrl> key. When used in connection with other keys, 
this key can enter ASCII codes smaller than code number 32. The following figure 
shows which keys can be accessed. 
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a — ms ~ mo] 
nw wo Pan 
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Ctrl B 


‘Dec | Symbol (Keystrokes 


Ctrl F 


os 
o> 
rei 
— 


r 
Backspace, 
Shift—- 
Backspace 


Ctrl M,., 


Shift 


Ctrl-Space, 
Alt-Space 


Character input with the <Ctrl> key 
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Function 0: Read keyboard 


ASCII 


Interrupt 16H normally receives a call when a program expects user input of one or 
more characters. If a character was already entered before the function call, the 
keyboard buffer empties this character and passes it to the calling program. If there 
is no character in the keyboard buffer, function 0 waits until a character has been 
input and then returns to the calling program. The caller can determine the 
character or activate a key from the contents of the AL and the AH registers. 


If the AL register contains a value other than 0, it contains the ASCII code of the 
character. The AH register contains the scan code of the active key. The code in the 
AL register corresponds to the ASCII codes for character output on the screen. 
Some differences occur in the control keys: 


[Code | Key(s) 
[8 <Backspace> 
Ea (SE DET 


Scan codes 


The scan code in the AH register indicates the number of the active key, where the 
keys on the keyboard are numbered starting with 0. Since PC, XT and AT 
keyboards differ, this is unimportant for most programs. Scan codes of the various 
keyboards can be found in the Appendices of this book. 


Extended key codes 
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If the AL register contains the value 0 after the call, the AH register indicates an 
extended keyboard code. The difference between the ASCII code and the extended 
keyboard code lies in the fact that certain keys (e.g., the cursor keys) cannot fit 
within the PC's 256-character set. The following table provides an overview of 
extended keyboard codes: 


15 <shift><Tab> 
144-50__| <Alt><Z>, <X>, <C>, <V>, <B>, <N>,<M> 


15 
sce SOU SOE a 


<Cursor Right> 
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Code (s) 
79 cEnd> 
HO oe ce Ce DOWN a i a 
[81 <Page Down> 
BS a 
[63 <Delete> 


719 
81 | 
82 
83 


Key combinations not contained in this table cannot be sensed using the BIOS 
keyboard functions, since they don't generate keyboard codes. 


Function 1: Read keyboard 


Function 1 also reads the keyboard. Unlike function 0, function 1 leaves the 
preceding character in the keyboard buffer. Repeated calls of function 1 or function 
0 read the keyboard again. Place the value 1 in the AH register to call function 1. 
In contrast to function 0, function 1 immediately informs the calling program with 
the zero flag after the function call if a character is available or not. If the zero flag 
equals 1, no character was available. If the zero flag resets, the AL and the AH 
registers contain information about the activated key. As in function 0, the AL 
register contains the value 0 if the user activated an extended key, and a value 
unequal to 0 if the user pressed a "normal" key. The AH register contains the scan 
code of normal keys; extended keys place their codes in the AH register. 


Function 2: Read control keys 


Function 2 has a completely different task. It reads the status of certain control 
keys and conditions (e.g., <Insert>). Place the number 2 in the AH register to call 
the function. The keyboard status can be found in the AL register after the function 
call. 
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Keyboard status byte 


Demonstration programs 


The following programs demonstrate the various functions of BIOS keyboard 
interrupts as presented here. The four programs can be divided into two groups. 
The first three programs are written in the higher level languages used throughout 
this book. They call the various functions of BIOS keyboard interrupts for their 
own uses. The fourth program is an assembler program. It modifies the BIOS 
keyboard interrupt functions and processing, and acts as a resident program which 
can be accessed at a keypress. 


Checking key status 
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All three higher level programs make a subroutine or a function available for 
reading characters from the keyboard. This alone is nothing special, since these 
languages have their own instructions that serve the same purposes. The important 
feature of the function is that it accepts other jobs in addition to the original task 
of reading characters. It displays the status of the keyboard functions <Insert, 
<Caps Lock> and <Num Lock> in the upper right hand corner of the screen. This 
is especially useful for XT and PC owners, since most keyboards don't indicate the 
key status. AT keyboards and some XT keyboards provide light emitting diodes 
(LED) which indicate the status of these keys. You never really know if the 
<Insert> or <Caps Lock> mode is on or not. 


Each program begins with a routine which reads the status of the keyboard 
functions through function 2 of BIOS keyboard interrupt 16H. Since the program 
only uses the <Insert>, <Caps Lock> and <Num Lock> modes, the program only 
views the three highest level bits in the keyboard status byte. Based on this status 
byte, a flag initializes for every keyboard function, which indicates the status of 
one of these functions or modes within the program. It is reversed when compared 
with the current mode. For example, if the <Insert> mode is switched off, the flag 
applying to it changes to OFF. An explanation of this follows below. 
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Calling the interrupt function 


After initializing the internal flags, the actual routine for keyboard reading can be 
called. It also uses function 2 of the BIOS keyboard interrupt to read the keyboard 
function status. It then compares the current status of each individual function with 
the previous status stored in a flag. During its first call after the initialization 
routine, it determines if the status of all three functions has changed since its 
previous status. The change in status causes the routine to display the new status 
on the screen. 


This explains the reason for the flag reversal in the initialization routine. It allows 
display of the keyboard function status on the screen during the first call of the 
keyboard routine, and not after it changed by pressing a key. 


Now the routine can proceed to its actual task and read the keyboard. It uses 
function 1 of the BIOS keyboard interrupt to detect whether a key is available in 
the keyboard buffer of BIOS. If this is not the case, the program jumps to the 
beginning of the routine and reads the keyboard function status again. This creates 
a loop which runs until a keypress occurs. This loop ensures that any status 
change is documented immediately on the screen. 


Reading the keys 


If a character appears in the BIOS keyboard buffer the loop terminates and BIOS 
keyboard interrupt function 2 reads the key. The last step of this routine tests for 
an extended key code. If this is the case, the program adds 256 to the code to signal 
the calling routine that an extended keyboard code was received. Then control 
returns to the calling routine. 


This routine reads characters from the keyboard and displays them on the screen. 
This process repeats until the user presses a certain key. If the user presses the 
<Num Lock>, <Caps Lock> or <Insert> key, the screen immediately displays the 
result. 


A centralized keyboard routine as presented here can be used in other programs for 
additional tasks. For example, with the help of this routine a macro conversion can 
change one key into a string of characters. Another application could display help 
text on the screen when the user presses a certain key. Lotus 1-2-3® and dBASE® 
use this method for displaying help screens. 


Note: A small problem occurs with keyboard flag output. Since displaying 
keyboard flags on the screen changes the cursor's position, 
Subsequent screen output from the program occurs at different 
locations than expected. These can disturb the screen display. To 
prevent this, the keyboard routine must determine the current cursor 
position before the keyboard flag display. Then the routine must 
restore the cursor position to its old value after displaying keyboard 
status. The problem of color is very similar. Here the flag output 
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assumes a certain color and the old color must be restored after the 
output. The problem is that none of the three languages has a 
command to determine the current color. In Pascal programs for 
keyboard reading, only a special procedure can set the color by 
recording the colors in a variable and setting it with a command. 
With these variables the keyboard routine restores the current color 
after display of the individual flags. 


BASIC listing: KEYB.BAS 
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100 UCR K KKK KKKEKKKEKKKEKKKEKREKEKKKEKKKEKKKEKEEKEKKEKEKEREKEKEKKAKEKEKKKKKK 
110 ‘* KEYB =e 
VDD 8 Weare ae cee a ce re ae a ee a ne ee en a ee a a HN A YS a een se xe 
130 '* Task : makes a subroutine available which x 
140 '* reads a character from the keyboard. The =! 
150 '* status of the control keys zs 
160 '* (INSERT, CAPS, NUM) are displayed ns 
170 '* on the screen ae 
180 '* Author : MICHAEL TISCHER at 
190 '* developed on : 7.22.87 = 
200 '* last Update : 9.21.87 = 
210 CRE KEKE KKK IKI KEKE KEK KKK KKKEKEKEKREAKKKEKKKKK 
220 § 

230 CLS : KEY OFF 

240 PRINT"WARNING: This Program can only be started if GWBASIC was " 
250 PRINT“started from the DOS level with <GWBASIC /m:60000>." 

260 PRINT : PRINT"If this is not the case, please input <s> for Stop." 
270 PRINT“Else press any key..."7 

280 AS = INKEYS : IF A$ = “s*® THEN END 

290 IF AS = "" THEN 280 

300 GOSUB 60000 ‘install function for Interrupt call 

310 CLS ‘Clear Screen 
320 PRINT“TAST (c) 1987 by Michael Tischer" : PRINT 

330 PRINT"You can input some characters and change the status of the NUM," 
340 PRINT"CAPS and INSERT mode, where every change is documented in “ 
350 PRINT“the upper right corner of the display." 

360 PRINT"The input of <RETURN> terminates the Program..." : PRINT 
370 PRINT"Your Input: “; 

_ 380 GOSUB 50000 ‘initialize keyboard-Flags 

3390 GOSUB 51000 -  ‘"yead a character 

400 IF LEN(2$) = 2 THEN 390 ‘on extended Code do nothing 

410 PRINT ZS; ‘output characters 

420 IF ASC(Z$) <> 13 THEN 390 ‘on RETURN terminate 

430 PRINT 

440 END 

450 ' 

50000 CHK KKKKEKAEKERKKKKKEKEKKEKEKEKKEKKEKKKKEKKKKKEKEKKKEEKEKEKEKEKEKKKK 
50010 ‘* initialize keyboard-Flags sis 
50020 '*-~~--~—------ +--+ - + ne ne sal 
90030 '* Input: none soo 
50040 ‘* Output: none ’ = 
50050 '* Info : the Variable 2% is used as a Dummy *s 
50060 ‘'* the Status of the keyboard Flags is stored in *! 
50070 ‘* variables INSERT%, CAPS% and NUM% ws 
50080 UHRA HAKKAR KEKE KEKE KKK REAM KEK KEKKKEKKKS 
50090 ' 

90100 FKT%=2 ‘get function number for keyboard status 
50110 INR%=&H16 ‘call BIOS-keyboard-Interrupt 16 (h) 


90120 CALL IA(INR%&, FKT%, FLAGSS, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, Z%, 2%) 
90130 IF FLAGS% AND 128 THEN INSERT% = 0 ELSE INSERTS = -1 
50140 IF FLAGS% AND 64 THEN CAPS% = 0 ELSE CAPS% = -1 

590150 IF FLAGS%$ AND 32 THEN NUM% = O ELSE NUM% = -1 

50160 RETURN ‘back to caller 

50170 ! 


SLOOO PAAR RAAARAKK KKK KKEREKEKEEKKEKEKKEKEEKK AEE KEKKEKEKEKEEKEKEKRKEKEKKEEK 
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51010 '* get a character from the keyboard and maybe output ie 
51020 '* Flag-Status a 
91030 | tan nn a nn rr nn rr rn srs a itt 
51040 ‘'* Input: none ie 
591050 '* Output: Z$ = the character read "= 
51060 ‘* Info : the Variable 2% is used as Dummy ~ 
51070 ‘* if 2$ is two character long, an extended x 
51080 ‘* keyboard code was input. The first character of the*' 
51090 '* string is in such a case the NUL-character, ws 
51100 '* and the second character indicates the Code of the *' 
re 3 a es extended key x? 
51120 PRK K KKK KK ERKKKK KEKE KEKE KKKHKEEKE KK KKKKAKKEKREKMKEKEKEKEEKKKEKEKKEKEKKEK 
SiES0 7 

51140 FKT%=2 ‘get function number for keyboard status 
51150 INR%=&H16 ‘call BIOS-keyboard-Interrupt 16 (h) 


51160 CALL IA (INR%, FKT%, FLAGS%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, Z%) 
51170 IF INSERT% = ((FLAGS% AND 128) = 128) THEN 51230 
51180 INSERT% = NOT INSERT% ‘Insert~Status has changed 


51190 COLMN% = 75 ‘Column for Insert-Text 

51200 FLAG& = INSERTS ‘Status of Insert-Flags 

51210 FTEXTS = "INSERT" ‘Flag-Text 

51220 GOSUB 52000 ‘output Flag-Text 

51230 IF CAPS% = ((FLAGS% AND 64) = 64) THEN 51290 

51240 CAPS% = NOT CAPS% 'Caps-Status has changed 

51250 COLMN% = 69 ‘Column for Caps-Text 

51260 FLAG% = CAPS% ‘Status of Caps-Flag 

91270 FTEXTS = “ CAPS " 'Flag-Text 

51280 GOSUB 52000 ‘output Flag-Text 

591290 IF NUM% = ((FLAGS% AND 32) = 32) THEN 51350 

51300 NUM% = NOT NUM% ‘Num-Status has changed 

51310 COLMN% = 66 ‘Column for Num-Text 

51320 FLAG$ = NUM% ‘Status of Num-Flag 

51330 FTEXTS = “NUM" ‘Flag-Text 

51340 GOSUB 52000 ‘output Flag-Text 

51350 FKT%=1 ‘test function number for characters 
51360 INR%=&H16 ‘call BIOS-keyboard-Interrupt 16 (h) 


51370 CALL IA(INR%, FKT%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 26, FLAGREG$) 
51380 IF (FLAGREG% AND 64) = 64 THEN 51140'no key --> get Flags 
51390 2S = INKEYS 


51400 RETURN ‘back to caller 

51410 ! 

52000 CREEK KKEKEK KK KKK KK KH KK KERR KKK KKH KKK KEKKKKK KAKA KKEKAKKKE 
52010 ‘* Set Cursor Position “ 
52020 ! % anew nn enn a en a 
52030 '* Input: FLAGS% = Status of Flags either on or off gies 
52040 '* FTEXTS = Flag~-Text ae 
52050 '* COLMN% = is the new column for Cursor =e 
52060 '* CLINE&’ = is the new line for Cursor = 
52070 ‘* Output: none = 
52080 ‘* Info >: the Variable Z% is used as a Dummy = 
52090 ORK KKK RK KEKE KKK KKK RK ERK KKK RK KKK KKK KKK KKEKKKKKEKKEKKEKEKEKEEKEKKKEKS 
52100 ! 

52110 CURCLINE% = CSRLIN-1 ‘record current Cursor line 
52120 CURCOLMN% = POS(0)-1 ‘record current Cursor column 
92130 LOCATE 1, COLMNS% ‘Cursor position for Flag-Text 


52140 IF FLAGS THEN COLOR 0,7 ELSE COLOR 0,0 
52150 PRINT FTEXTS 


52160 LOCATE CURCLINE%+1, CURCOLMN%$+1 ‘set old Cursor position 
52170 FKT%=2 ‘set function number for Cursor position 
52180 INR%=&H10 ‘call BIOS-Video-Interrupt 10 (h)} 

52190 SEITE% = 0 ‘set Cursor in display page 0 


92200 CALL IA(INRt, FKT%, 2%, SEITE%, 2%, 2%, 26, CURCLINE%, CURCOLMNS, 2%, 2%, 2%, 2%) 
92210 COLOR 7,0 


52220 RETURN ‘back to caller 

52230 ' 

60000 CaM KKH KK KK RKKK KEE KK KKK KARR EREEKKEKEKKKHKKKKKEKKKEKEEKEKKKKEEK 
60010 '* initialize the Routine for Interrupt-call a“ 
60020 | *----~-~-- + + ee ~s 
60030 ‘* Input: none ae 


60040 ‘** Output: IA is the Start address of the Interrupt-Routine mt 
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60050 CREEK KEKE KKK KKEK KEKE KKEKEKEKEKKEKKEKKEKKEKKEKEKKEKKKKEKKKKKEKKKS 


60060 ' 
60070 IA=60000! ‘Start address of the Routine in the BASIC-Segment 
60080 DEF SEG ‘set BASIC-Segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+tI%,X% : NEXT ‘poke Routine 
60110 RETURN ‘back to caller 

60120 ' 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 


Pascal listing: KEYP.PAS 


{ BARAK RHEK EKER EKER EKEEKKKEKEEKEKKEKEKKEEKRKKEKKEEREKKEKEREKEEEKKEKEEKEKEKK KE | 


{* KEY P *} 
{* ee ss a ers Simi el Soe Su Se, ihc Sh i a lbw si sn tile i as oa sloop ls as se en nh le a ees ea ei se Si se =e ene Gu te a a: *} 
{* Task : makes a function available for reading a *} 
{* character from the keyboard and outputting *} 
{* the Status of the control keys (INSERT, *} 
{* CAPS, NUM) on the display. *} 
{* ces can ics ls ms meu enemas ems em Cems ase sms nm rms ens cn cs sass mem ects el ce en eu ‘assess ibs soe au nm cei uses essa sre us ses Cs ee cs cu Goch Gas mh SSeS cave SAG mabe ios en cca ume *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 07/08/87 *} 
{* last Update : 06/10/89 *} 


{8 RAR RK RK IKK IK III KEK EK IIIA KIRK RII KERR K RARER ERE IKKEKEKEKEEEE EE | 


program KEYP; 


Uses Crt,Dos; ; { Add Crt, Dos units } 
{$v-} { Suppresses string length check } 
type FlagText = string[6]; { used for passing the Flag-Name } 
const FZ = 1; ' { Line in which the Flags are output } 
FS = 65; { Column from which Flags are output } 
FlagFore = 0; { Foreground color of Flags } 

} 


FlagBck 


| 
~J 
“=e 


{ Background color of Flags 


{** BIOS keyboard status bits RHKKKKKKKKEKEKEKEKEREKEEREKEKEEKREEKK KE | 


SCRL = 16; { ScrollLock bit } 
NUML = 32; { NumLock bit } 
CAPL = 64; { CapsLock bit } 
INS = 128; { Insert bit} 
{** Codes of some keys as presented by GETKEY ******xxkrekkke ee } 
BEL = 7; { Code for bell character } 
BS = 8; { Code for Backspace character } 
TAB = 9: { Code for Tab character } 
LF = 10; { Code for Linefeed } 
CR = 13; { Code for Return } 
ESC = 27; { Code for Escape character } 
Fl = 315; { Code for Fl key } 
F2 = 316; { Code for F2 key } 
F3 SLi: { Code for F3 key } 
F4 = 318; { Code for F4 key } 
F5 = 319; { Code for FS key } 
F6 = 320; { Code for F6 key } 
F7 = 321; { Code for F7 key } 
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F8 = 322; { Code for F8 key } 
F9 = 323; { Code for F9 key } 
F10 = 324; { Code for F10 key } 
CUP = 328; { Code for Cursor up } 
CLEFT = 331; { Code for Cursor left } 
CRIGHT = 333; { Code for Cursor right } 
CDOWN = 328; { Code for Cursor down } 
var Insert, { Status of INSERT flag } 
Num, { Status of NUM flag } 
Caps : boolean; { Status of CAPS flag } 
ForeColor, { current foreground color } 
BckCcicr, i current background colcr } 
key : integer; { Code of key read } 


{ RAR RIKI KK RK IKK RRR KEKE KEE KERR KER KKK REE KK RKREEEEEREREKKEKE EE | 


{* NEGFLAG: negate Flag and output Text *} 
{* Input : s.u. *} 
{* Output : the new Status of the Flags (true = on, false = off) *} 


{RRR RR RRR RRR ER RK KEK RK RRR REE ERRERE RR EKEKEHEREKREKKEKKEKKKEEKEKEKKEK EK} 


function NegFlag (Flag : boolean; { the last Status of the Flags 
FlagReg, { current Status of the Flag (0 = off) 
Column, { Column for the name of the Flags 


Cline : integer; { Line for the Names of the Flags 
Text : FlagText) : boolean; { Name of the Flags 


var CurCline, { current Line } 
CurColumn ;: integer; { current Column } 
begin 
if (Flag and (FlagReg = 0)) or { test if Status } 
(not (Flag) and (FlagReg <> 0)) then { of the Flags has changed } 
begin : { YES } 
CurCline := WhereyY; { record current Line } 
CurColumn := WherexX; { record current Column } 
gotoxy (Column, Cline); { Cursor to Position for Flag-Name } 
if FlagReg = 0 then { is Flag reset? } 
begin { YES } 
NegFlag := false; { Result of the function : Flag off } 
textcolor (0); { Foreground color is black } 
textbackground (0) ; { Background color is black } 
end 
else 
begin { Flag is now on } 
NegFlag:=t rue; { Result of the function : flag on } 
textcolor (FlagFore); { Foreground color is FLAGFORE} 
textbackground (FlagBck) { Background color is FLAGBCK } 
end; 
write (Text); { Output name of the flag } 
gotoxy (CurColumn, CurCline); { restore old cursor position } 
textcolor (ForeColor); { restore old foreground color } 
textbackground (BckColor) { restore old background color } 
end 
else 
NegFlag := Flag { Status of flags has not changed } 
end; 


{RAR RRR REE RIKER RRR KKK EKER ERK KE REE EER EKER EEEEKERKEER | 


{* GETKEY: Read a character and output the flag status *} 
{* Input : none *} 
{* Output : Code of the key < 256 : normal key *} 
i >= 256 : extended key *} 


{RA AAKKRKEAKHKHKEARHRE RE RERKKKRERKEEREEKEEEREKREKKRKKEKKEKREKREREREKRREKEREKEKK) 


function Getkey : integer; 


var Regs : Registers; { Register variable for interrupt call } 
keyRec : boolean; { indicates if key already received } 
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begin 
keyRec := false; { no key received } 
repeat 
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{ read function number for keyboard status 
{ call BIOS keyboard interrupt 


Regs.ah := $2; 
intr($16, Regs); 


} 
} 


{** Adjust flags to new status KRHA KEKE AKEKEEREREKEKREEKEKEKEE } 


Insert := NegFlag(Insert, Regs.al and INS, FS+9, FZ, ‘INSERT'); 
Caps := NegFlag(Caps, Regs.al and CAPL, FS+3, FZ, ‘ CAPS ‘); 
Num := NegFlag(Num, Regs.al and NUML, FS, F2, '‘NUM'); 
Regs.ah := $1; { function number for character ready? 
intr($16, Regs); { call BIOS keyboard interrupt 
if (Regs.flags and FZero = Q) then 
begin 

KeyRec := true; 

Regs.ah := 0; 

intr($16, Regs); 


if (Regs.al = 0) { is zero flag set ? 


ee 


— 


then Getkey := Regs.ah or $100 { YES } 
else Getkey := Regs.al; { NO } 
end; 
until keyRec; { repeat until a key is received } 
end; 


{RARER KERRIER KEK RRR ER KEKE KERR RE RK RRK RK ER KEKE KKK EKEREERKEEEEEKKER 


{* INIKEY: initialize keyboard flags 


= 
*} 


{* Input : none *} 
{* Output : none 8 
{* Info : the keyboard flags are inverted from the current *} 
{* status. This outputs their current *} 
{* status during the next call of the GETKEY function. *} 


{RRA E HEHE E KKK EKER KK EKER KKKKERKKREKKKKEAEEKEEEKEKERKKEKEKEEAKEEKERE 


procedure Inikey; 


var Regs : Registers; { Register variable for interrupt call 


begin 
Regs.ah := $2; 
intr($16, Regs); 


{ Read function number for keyboard status 
{ call BIOS keyboard interrupt 
if (Regs.al and INS <> 0) then Insert := false { INSERT flag 


} 

} 

} 

else Insert := true; { set } 

if (Regs.al and CAPL <> 0) then Caps := false { CAPS flag } 
else Caps := true; { set } 

if (Regs.al and NUML <> 0) then Num := false { NUM flag } 
else Num := true { set } 


end; 


{RR ARR RRR RRR RRR RR IRR RR RRR RRR KERRIER ERR KKK RE RK R KERR K KEKE KKK EK 


{* SCOLOR: sets foreground and background colors for display 


{* Input : see below 
{* Output : none 
{* Var. : the color is stored in the global variables FORECOLOR 


L* and BCKCOLOR 


ai 


my 
a 


{* Info : this procedure must be called for setting the color *} 
i so that after the output of the keyboard flag status, *} 
ts the current text color can be restored x 
es Since in TURBO no functions exist for sensing *} 
{* this color *} 


{ RAR RRR RRR RR RK KK RR KR KR KKK ERK KEKE KKK KK KE KEK KK KKEKEK KEK 


procedure Scolor (Foreground, Background : integer); 


begin 


i 


ForeColor := Foreground; 
BckColor := Background; 
textcolor (Foreground) ; 
textbackground (Background) 
end; 


{ Record foreground color 
{ Record background color 
{ Set foreground color 
{ Set background color 


Te ed 
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{ FEAR HK ARKH RK EERE REE EKKEKKEERKKEKKKK EEE KE KEE KAR EEEKEKKKEEKKEKKKKEKE | 


{* MAIN PROGRAM *} 


{ RE RRRRARK EK ERK KEKE K KEKE ERIK RK KEKE KEK KKEKEKEKKKKAKKKKERKEKKKEKKEKEKE | 


begin 
Inikey; { Initialize keyboard flags } 
Scolor (7,0); { Color is white on black } 
clrscr; { Clear screen } 


writeln(#13#10'KEYP (c) 1987 by Michael Tischer'); 

writeln(#13#10'A few characters can be input now and switch '+ 
*INSERT-, CAPS- or NUM-'); 

writeln(‘mode on or off. The status of the three '+ 
‘modes is always displayed in'}; 

writeln('the upper right corner of the screen.'); 

writeln('Pressing the <RETURN> or the <Fl>-key terminates the ‘+ 
‘program...'); 

write (#13#10'Your Input: ‘'); 


repeat { Input loop } 
key := Getkey; { Get key } 
if (key < 256) then write (chr (key) ) { Output (if normal) } 
until (key = 13) or (key = Fl); { Repeat until Fl or CR } 
writeln; 

end. 


C listing: KEYC.C 


[RRR IKK RK KR IIKIKRIKKKIKKKKIKIKKIKIKKEKKKKKEKEKEK EKER IKKE KEKE EKER KKK / 


/* KEYC */ 
/* sn isn tne sts itn tin iW mina Sa GO Sia hn Sei yh ev: nS: i cs mn hl ee refs Sse Aoi em me so lv Sr ss i i i yo ins */ 
/* Task : provides a function for reading a *] 
a character from the keyboard and to output x} 
/* the Status of the control keys (INSERT, */ 
/* CAPS, NUM) on the display. x} 
a i ad i a ee i SN A aa es Ia * / 
Yaa Author : MICHAEL TISCHER *y 
[* developed on : 8/13/87 */ 
/* last update : 6/09/89 al | 
/* Sa a cm Ss a Si es es se es Se wenn ic Si ssn smi ‘es ew tx es es as mes kt a ea es i a en sel a ee ee x/ 
T* (MICROSOFT C)} */ 
/* Creation : MSC TASTC; x] 
/* LINK TASTC; ay A 
/* Call : TASTC */ 
/* Sete a ee Se ee eae eae oe ee aaa ee Soe ee eee a/ 
7* (BORLAND TURBO C) ai 5 
j= Creation : Make sure that Case-sensitive link is OFF in */ 
[= the Options menu/Linker option */ 
fas Select RUN menu af 


[BKK KKK KKK KIKI KKK IKK KKK KEK IK IKI KHAKI KEK KAKA IKKIKKKKAKKK KKK AK / 


#include <dos.h> /* include Header-Files */ 
#include <io.h> 
#include <bios.h> 


typedef unsigned char byte; /* Create a byte */ 
/*-~- Bit layout in BIOS keyboard status ----~-----------------------=- 6 
#define SCRL 16 /* ScrollLock bit */ 
#define NUML 32 /* NumLock bit */ 
#define CAPL 64 /* CapsLock bit */ 
#define INS 128 /* Insert bit */ 
#define FALSE 0 /* Constants make reading of the */ 
#define TRUE 1 /* Program text easier ay, 
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#define FZ 0 /* Line in which the Flags should be output */ 
#define FS 65 /* Column, in which Flags will be output */ 
#define FlagColour 0x70 /* black characters on white ground */ 
/*-- Codes of some keys as returned by GETKEY() --------------------- a & 
#define BEL 7 /* Bell character code */ 
#define BS 8 /* Backspace key code */ 
#define TAB 9 /* Tab key code */ 
#define LF 10 /* Linefeed code */ 
#define CR 13 /* Return key code */ 
#define ESC 27 /* Escape key code */ 
#define Fl 315 /* Fl key code */ 
#define F2 316 /* F2 key code */ 
#define F3 317 /* F3 key code */ 
#define F4 318 /* F4 key code */ 
#define F5 319 /* FS key code */ 
#define F6 320 /* F6 key code */ 
#define F7 321 /* F7 key code */ 
#define F8 322 /* F8 key code */ 
#define F9 323 /* F9 key code */ 
#define F10 324 /* F10 key code */ 
#define CUP 328 /* Cursor up code */ 
#define CLEFT 331 /* Cursor left code */ 
#define CRIGHT 333 /* Cursor right code */ 
#¥define CDOWN 328 /* Cursor down */ 
/*-- global Variables -------------- 2-9-9 2 nn rn nnn */ 
byte Insert, /* Status of INSERT flag */ 

Num, /* Status of NUM flag */ 

Caps; /* Status of CAPS flag */ 
[IIIS OIG ITI IOICICIICICICIOICIOISIOICICIGI CII GIAO IIIA IOI IIIA TIA AIC] 
/* GETPAGE: get the current display page a 
/* Input : none aif 
/* Output ; see below oy 


[HK RT TK TRO TRIO TOK TORK RR RIK KR KKK RE KRK RK KKK KKK IK / 


byte GETPAGE () 


{ 


union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 15; /* function number */ 
int86(0x10, &Register, &Register); /* call interrupt 10(h) */ 
return (Register.h.bh); /* Number of current display page */ 


} 


[RRR KK KERR RK RIKER KEK KEE REIKI KEK EK AKIRA REKEKEKKKKEEKEKK / 


/* SETPOS: sets the position of cursor in current display page *] 
/* Input : see below */ 
/* Output : none */ 
/* Info : the position of the blinking cursor changes oy 
/* with the call of this function only if lf 
7* display page indicated is the current display page */ 


[BRK IH I RK I IK ITI I TK IK III IH KIKI IK ITA EIA KEKE EKER AK IKK / 
void SetPos (byte Column, byte Line) 


{ 


union REGS Register; /* Register-Variable for Interrupt call */ 
Register.h.ah = 2; /* function number */ 
Register.h.bh = GETPAGE(); /* Display Page */ 
Register.h.dh = Line; /* Display Line */ 
Register.h.dl = Column; /* Display Column */ 
int86(0x10, &Register, &Register); /* call Interrupt 10(h) */ 


} 


[RR IIH KI IKK I ITI ITOK TOTTI IK TKR KARE KEK KEKE AKER EEKKE / 
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/* GETPOS: Gets the Position of Cursor in the current Display Page *7 
/* Input : none af 
/* Output : see below */ 


[RII IK ITT IK TTR IR KKK IKI HIRI RIE KKK KKK KKK IK KAKA K KK KK / 


void GetPos (byte * CurColumn, byte * CurLine) 


{ 


union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 3; /* function number */ 
Register.h.bh = GETPAGE (); /* Display page */ 

intR6lOx10, sRegister, sRegister); /* call Interrupt 10h) */ 


/* Result of the function */ 
/* Read from the register */ 


*CurColumn = Register.h.dl; 
*CurLine = Register.h.dh; 
} 


[BRK IIR TOK TKI KORO TIO RIO TOIT TOK KIKI TKR IKK ERK KKK KKK KK IK / 


/* WRITECHAR: writes a character with an Attribute to ait bi 
/* the current cursor position in current display page a 
/* Input : see below all f 
/* Output : none iid 


TI IIIT ITO II OI KR KOK II ROI IOI III KOI TOR IIIT IK ITOK KI TICK IKK IK KICK KK KK / 


void WriteChar (char Zcharacter, byte Colour) 


{ 


union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 9; /* function number */ 
Register.h.bh = GETPAGE (); /* Display Page */ 
Register.h.al = Zcharacter; /* the character for output */ 
Register.h.bl = Colour; /* Color of character to be output */ 
Register.x.cx = 1; /* output character only once */ 
int86(0x10, &Register, &Register); /* call Interrupt 10(h) */ 


} 


[KKK KIKI IKK KI KKK KKK KI IK KICK KKK KK KKK KRHA KKE KEKE IKKIEK KEKE / 


/* WRITETEXT: write a character chain with constant color x/ 
c* Starting at a certain location in the current *7 
{* Display Page a 4 
/* Input : see below xf 
/* Output : none aif 
/* Info : Text is a Pointer to a character-Vector which */ 
/* contains the Text to be output and is terminated with */ 
ha a '\O' character. Pf 


JR RII IK IIIT ITOK OKI TOIT III ROTI ITOK III TICK KC / 


void WriteText (byte Column, byte Line, char *Text, byte Colour) 


{ 
union REGS InRegister, 


Out Register; /* Register variable for interrupt call */ 
SetPos (Column, Line); /* set Cursor */ 
InRegister.h.ah = 14; /* function number */ 
InRegister.h.bh = GetPage( ); /* Display Page */ 
while (*Text) /* output Text until '\O' character */ 


{ 
WriteChar(' ', Colour); /* Indicate color for character */ 
InRegister.h.al = *Text++; /* the character for output */ 
int86(0x10, &InRegister, s&OutRegister) ; /* call Interrupt */ 
} 
} 


[RR RRR RIKER IIR KK RK IK KI TTR IK IT TT KITT RIT HII IKI KKK KIN KKK / 


/* CLS: erase current Display Page ~/ 
/* Input : none +7, 
/* Output : none +7 


[RR III RIK KIT KK KK KITT RI TKI TTT TR KK TT TTR IRE RK TI KE KK KK / 
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void Cls({) 

{ 

union REGS Register; /* Register variable for interrupt call */. 
Register.h.ah = 6; /* function number for scroll up */ 
Register.h.al = 0; /* 0 stand for clear */ 
Register.h.bh = 7; /* white letters on black background */ 
Register.x.cx = 0; /* upper left display corner */ 
Register.h.dh = 24; /* Coordinates of the lower */ 
Register.h.dl = 79; /* yight display corner */ 
int86(0x10, &Register, &Register); /* call BIOS-Video-Interrupt */ 
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} 


[RRR IIH I KI TI KT TK KI ITT IH III IIT KT HITE KIKI RIAA IKEKEK KKK f 


/* NEGFLAG: negate Flag and output Text a 
/* Input : see below of 
/* Output : the new Status of Flags (TRUE = on, FALSE = off) */ 


[RRR KIKI REIKI IIR KEKE KKK IK IK IKE RIK IK EK KEKE KKK IKK IK KEKKKEKEEEE / 


byte NegFlag (byte Flag, unsigned int FlagReg, 
byte Column, byte Line, char * Text) 


{ 


byte CurLine, /* current Line */ 
CurColumn, ; /* current Column */ 
Colour; /* for Output of Flag-Text */ 
if (! (Flag == (FlagReg != 0))) /* did Flag change? */ 
{ /* YES */- 
GetPos (&éCurColumn, &CurLine); /* get current Cursor position */ 

WriteText (Column, Line, Text, (Flag) ? 0 : FlagColour); 
SetPos (CurColumn, CurLine); /* set old Cursor position */ 
return (Flag *1); /* reverse Bit 1 of Flags */ 

} 

else return (Flag); /* everything remains the same */ 


} 


[RRR RIKKI IKK RII IK IKK AI I KKH KKEKEEEE / 


/* KEYREADY: Tests for a character from the keyboard */ 
/* Input: none i A 
/* Output: TRUE if a key is pressed, otherwise FALSE ny 


[RRR RK IKI IRR RIKKI IKI KAI TKK KAKI KKK KAA IRR A KI KIREAAREKIKRITKKIHKKE / 


int KeyReady () 


{ 
#ifdef TURBOC _ 


struct REGPACK Register; 

Register.r_ax = 1 << 8; 

intr (0x16, &Register); 

return(! (Register.r flags & 64) ); 
#else 


return( bios keybrd( KEYBRD READY ) ); 


fendif 
} 


[IRI TT IK RI IKI RIK IO TO IIT KK ITI KK ERIK KK EK KK / 


/* GETKEY: Read a character and Output Flag-Status n/ 
/* Input : none x] 
/* Output : Code of key read < 256 : normal key */ 
/* >= 256 : extended ke y of 


[RII III RK I KK IKK KIT IT ITI TTR TO RIK IK ITI IIIT KIKI KHIR IKN IKI K EK / 


Abacus 7.11 Accessing the Keyboard from the BIOS 


unsigned int GetKey () 


{ 


union REGS Register; /* Register Variable for Interrupt call */ 
do 

{ 

Register.h.ah = 2; /* read function number for keyboard status */ 


int86(0x16, &Register, &Register); /* call BIOS keyboard interrupt*/ 
Insert = NegFlag(Insert, Register.h.al & INS, FS+9, FZ, “INSERT") ; 
Caps = NegFlag(Caps, Register.h.al & CAPL, FS+3, FZ, “ CAPS "); 

Num = NegFlag (Num, Register.h.al & NUML, FS, FZ, “NUM"); 

} 

while ( !KeyReady() ); 

Register.h.ah = 0; /* read function number for key */ 
int86(0x16, &Register, &Register); /*call BIOS-keyboard-Interrupt*/ 
return((Register.h.al) ? Register.h.al : Register.h.ah | 256); 

} 


[BR I IK IKK II II KIT TT IO TK TOR TOI I KK KIKI KK HI IK KI ITI IHR IA AKER RII KAI KKKK KARE / 


/* INIKEY: initialize keyboard-Flags */ 
/* Input : none */ 
/* Output : none x/ 
/* Info : the keyboard-Flags are reversed compared with the at 
/* current status. This makes it possible that their ad 
7* current Status is output on the next call of the xy 
ss GETKEY~function, */ 


[RR IKK HK IK KIKI KK II IR ITO TOI HTT KIKI IKK IK IIHR ITI RHI IKKE KI IKEKK IKE / 


void Inikey () 


{ 


union REGS Register; /* Register variable for interrupt call */ 
Register.h.ah = 2; /* read function number for keyboard status */ 
int86(Ox16, &Register, &Register); /* call BIOS-keyboard-Interrupt*/ 
Insert = (Register.h.al & INS) ? FALSE : TRUE ; /* reverse the w/ 


Caps = (Register.h.al & CAPL) ? FALSE : TRUE ; /* current content */ 
Num = (Register.h.al & NUML) ? FALSE : TRUE ; 
} 


[RR I IK IK TOK IT ITO TROT ITOK TOK RIK KKK KKK KKK HIKER KEKE KEK KK KK / 


| hk MAIN PROGRAM hal 4 


[BR RIK I IK II TIO TOI IR TOI RIK RRR EK KKK KEK IKK KEK KR KKK KK / 


void main () 


{ 
unsigned int key; 


Cls(); /* Clear Screen */ 
SetPos (0,0); /* Cursor to left upper screen corner */ 
printf ("KEY (c) 1987 by Michael Tischer\n\n") ; 

printf ("You can input some characters and at the same time change "); 
printf ("INSERT-, CAPS-\nor NUM-status. Every change "); 

printf(“is displayed in the upper right corner of the screen.\n"); 
printf ("\n<RETURN> or <F1l> terminates the Input...\n\n"); 

printf ("Your Input: "); 


Inikey (); /* initialize keyboard-Flags */ 
do 
{ 
if ((key = Getkey())} < 256) /* read key */ 
printf ("%c", (char) key); /* output (if normal) */ 
} 
while (! (key == CR |{ key == F1)); /* repeat until Fl or CR */ 


printf ("\n"); 
} 
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A resident interrupt driver 
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The next assembler program is a resident interrupt driver. Once a resident program 
is installed in memory, other programs or data cannot overwrite it. Another reason 
for the name resident lies in the program's ability to point to an interrupt in its 
own routine. Instead of DOS, BIOS or another interrupt routine called up to now, 
the program calls its own interrupt driver routine. Before examining how this is 
done, the assembler program should be explained. 


The SHOWCLK program displays the current time on the screen every time the 
user presses a certain key after installing it. This occurs until another key is 
depressed. The key which causes the time to be displayed must be passed to the 
program in the command line during its call. For example, entering the following 
at the DOS prompt invokes the program and tells the program to display the time 
when the user presses the <F10> key on the XT, or the <F8> key on the AT 
keyboard. When the key is pressed, the time appears on the screen at line 1 starting 
at column 40: 


showclk 68 /11 /c40 


The following removes the SHOWCLK program from memory (note the lack of 
parameters): 


showclk 


The only stipulation is that the actuating key must be one that generates an 
extended key code (e.g., a cursor key or function key). The program sets the default 
clock position to the upper right corner of the screen. This can be changed by 
passing parameters in the command line during the program call. Another facet of 
the program is its ability to re-install itself during a new call, if the user desires. 


CHAK KKK KKKAKEKE AKER EKER KKK KEKE EREKEKEKREKREKKEKKKKK KKK « 


e ’ 
7s SHOWCLK * 
7s ee ae aa es ee ee ee ae ee ee ae cae Oa ee ce ee came cae ene ee cams came eee ce om ene ee ne 0 OD com ame cD cee cam ne OD ene SM Oe ED MS Se es eed seve MD cts eats nD ED CD OD em ene am nd amu i 
:* Task : Outputs the time on the display after pressing*; 
ed a key which generates an extended key code *s 
ne stops when another key is pressed - 
oe 0 coe oem eae ame es cn ene ca ca ew eae ca cam ca ee ne cee ere eam cam cn ew ee oe eee om ee om me we cee eee ee re ca ee ee oe oe ene so Oe Oe ee wen aD Oe SEO Oo Oo ms 
7* Author : MICHAEL TISCHER r 
7 developed on : 8/1/87 xs 
7% last Update : 9/21/87 we 
(0 "Ii se she as ik sed cca sn cb Sci eis ean ems mm nintendo ms ls cs un eet cs els Muah eu cb oa Gk Ged bums Glas aS Gene ek mi us us we an Gus tgs ave sain “ai ee cen Se ‘nos to's ws cm cues ew Gn es ke 
s e 
ze assembly : MASM SHOWCLK *s 
7 LINK SHOWCLK *; 
> EXE2BIN SHOWCLK SHOWCLK.COM *; 
os Oo ate Pe CD EO ST SO OD NT SD MD SAD ND AED ND SD SEEDS tS ND RS SS SS SY SS DP SD SD ND SND WA SG SP a SD PS <n GED SED aD ct tn SRS GND em ade 
:* Call : SHOWCLK [Key-code] [/lLine] [/cColumn] sg 
ZF RARER KKEKKEKRK EEK ERK KKK KKRKK KKK RE KEK KEKE EKA KEKE KEKE KEKEKEKREREKKKKKKEKREKE 9 


tA 


TAB equ 9 
LF equ 10 
CR equ 13 
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code 


Start; 


segment para 'CODE' ;Definition of the CODE-Segment 
org 100h 
assume csS:code, ds:code, es:code, ss:code 


jmp _ showinit 7;Call of the Initialization-Routine 


== Data (rema 4 n in memory) =a sree esse SSS SST Ue SSS 


alterint equ this dword 7old interrupt vector 16 (h) 

intaltofs dw (?) ;Offset address interrupt vector 16(h) 
intaltseg dw (?) ;Segment address interrupt vector 16 (h) 
ext key db (1) 7extended keyboard-code, on which 
keycode db (?) ;the program is called 

linepos equ this word 

column db 75 ;Line and column in which the time 

line db 0 zis output 

buffer dw 5 dup (?) ;stores the characters from the clock 


7== this is the new kyboard-interrupt (remains in memory) ========== 


newint 


newi 1: 


newi 2: 


showtime: 


getz: 


proc far 


jmp short newi_1 


db "MT" zIdentification of the program 

or ah,ah ;read character (Function 0)? 

je newi 2 7YES --> get character and test 

jmp aint 7NO --> call old interrupt 

pushf ;for smulation of an interrupt call 
call cs: f{alterint] 7call old interrupt 

cmp ax,CS:word ptr extkey ;was it the specified key? 

je showt ime 7YES --> display clock 

jmp aiend 7NO --> back 


7-- the specified key was activated ---------------------- 


pushf ;all registers which are changed 
push ax ; must be stored 

push bx 

push cx 

push dx 

push di 

push si 

push es 

push ds 

cld 70n sring commands count up 
mov ah,15 ;read current display page 
int 10h ;call BIOS video-interrupt 
mov ah,3 ;read current cursor position 
int 10h 7call BIOS video-interrupt 
push dx 7store on the stack 

push cs 7;Code-sgment to the stack 
pop ds ;return as DS 

mov dx, linepos ;set cursor position 

mov ah,2 ;for the time 

int 10h 7call BIOS video-interrupt 
push cs 7Code-segment to the stack 
pop es ;return as ES 

mov cx,5 ;read 5 characters 

mov di,offset buffer ;Address of the character-~buffer 
mov ah,8 ;read 1 character 

int 10h 7call BIOS video-interrupt 
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stosw sstore character in the buffer 
inc dl ;next display column 
mov ah,2 ;set cursor position 
int 10h 7Call BIOS video-interrupt 
loop getz 7get next character 
mov dx,linepos zset cursor position 
mov ah,2 7for the time 
int 10h ;call BIOS video-interrupt 
mov ah, 2CH zget time from DOS 
int 21h 7call DOS-interrupt 
mov bl,70h ;color of clock: inverted 
push cx ;record minutes 
mov al,ch ;change hours to ASCII 
call bia sand output 
mov al,":" 7output colon 
call prz 
pop ax 7;get minutes 

;function number for character output 
xchg bl,ah 7exchange AH and BL 
int 10h 7call BIOS video~interrupt 
inc dl 7next column 
mov ah,2 ;set cursor position 
int 10h 7call BIOS video-interrupt 
dec di ;output another character ? 
jne storz 7;YES --> STORZ 
pop dx ;get old cursor position 
mov ah,2 gand set again 
int 10h 3;call BIOS video-interrupt 
pop ds ;restore all stored registers 
pop es 
pop si 
pop di 
pop dx 
pop cx 
pop bx 
pop ax 
popf 


xor  ah,ah 
jmp newi 2 


aint: pushf ;simulate interrupt-routine 
call cs: f{alterint] 7Call next keyboard-routine 

aiend: ret 2 7flag-register 

newint endp 


’ 


tf 


’ 


tf 


bia 


me Me Me 


BIA: change binary to ASCII and output --------<----------------- 


Input : AL = the number to be converted 


Output ; none 
Register : CX, AX, DL and FLAGS are changed 


proc near 
mov cl,10 zwe work in the decimal system 

xor ah,ah 7prepare 16 bit division 

div cl ;divide AX by CL 

or ax,3030h 7Change result to ASCII 

push ax ;store number 

call prz ;output character and advance cursor 
pop ax ; read number 

mov al,ah ;move character to AL 

call prz 7output character and advance cursor 
ret ;back to caller 

endp 


PRZ: output character and increment cursor position ------------ 
Input : BH = Display page for Output 
AL = the character for output 
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os BL = Attribute (color) of the character 
7-~ Output : none 
z-- Register : CX, AH, DL and FLAGS are changed 


prz proc near 
mov ah,9 ;function number for character output 
mov cx,1l ;output character only once 
int 10h 3call BIOS video-interrupt 
mov ah,3 jread current cursor position 
int 10h ;call BIOS video-interrupt 
inc dl jincrement cursor column 
mov ah,2 7set 
int i0h ;Ccaii BIOS video-interrupt 
ret zback to caller 
prz endp 
instend equ this byte 7iff SHOWCLK installed, memory can be 
;released starting at this location 
badp db “Invalid Parameter",CR, LF, "$" 


installm db “SHOWCLK (c) 1987 by Michael Tischer",13,10,13,10 
db “SHOWCLK was installed and can be deactivated “,13,10 
db “with a new call ",13,10 
db “(but without Parameters) "“,CR, LF, "S$" 


deactivm db “SHOWCLK was deactivated",CR, LF,"S" 

allinm db “SHOWCLK is already installed",CR, LF,"S" 

noinstm db “no SHOWCLK installed",CR, LF, "S$" 

partab GQw 63 dup (?) ;Address of command line parameter 


deactivate label near ;turn SHOWCLK off 
mov axX,3516h 7get content of interrupt vector 16 
int 21h ycall DOS-Function 
cmp word ptr es: [bx+2],"TM" ;test if SHOWCLK-program 
jne noinst ;SHOWCLK not installed --> End 


mov dx,es:intaltofs 7Offset address of interrupt 16 (h) 


mov ax,es:intaltseg 7;Segment address of interrupt 16(h) 
mov ds,ax 7to DS 
mov ax,2516h ;reset content of 
int 21h ;interrupt vector 16(h) old routine 
mov ah,49h ;release storage 
int 21h 70f old SHOWCL again 
push cs ;store CS on the Stack 
pop ds ;restore DS 
ent fe: mov dx,offset deactivm ;Message: program removed 
xor al,al ;program performed correctly 
jmp showend ;to end of program 


noinst: mov dx,offset noinstm ;Error-Message: no SHOWCLK installed 
jmp short noinerr ;output Error-Message and terminate 


7-- Start and Initialization-Routine -~------~---------~-~---------------- 
showinit proc near 


cld 7on String commands count up 
mov di,offset partab 7Address of Parameter-Table 
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call parmtest ;count Parameter/determine Address 
or dl,dl rif no Parameter indicated 
je deactivate 7;YES --> remove last SHOWCL 
sevaluate Parameter -------------- = nnn nr 
mov bx,offset partab ;Address of the Parameter-Table 

paraout: mov si, [bx] 7get Address of a Parameter 
lodsw sget first two chars of parameter 
and ah,11011111b zlower case letters --> upper case 
cmp ax,"L/" zis it line indication ? 
je getline 7YES --> GETLINE 
cmp ax,"C/" zis it column indication? 
je getcolumn 7YES -~-> GETCOLUMN 
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7-- Parameter must be Key code 


nextpara: add 


getline: 


dec 
jne 
jmp 


mov 
mov 


jmp 


get column: mov 


pareval: 


allinst: 


badpara: 
noinerr: 


install: 


mov 


push 
push 
call 
pop 
pop 


jc 
or 
jne 
cmp 
ja 
mov 
jmp 


mov 
jmp 


mov 
mov 


jmp 


cmp 
jne 
mov 
int 


extkey, 0 
badpara 


bx 

ax 

si,2 
asciibin 
dx 

bx 


badpara 
ah,ah 
badpara 
keycode, al 
extkey, 0 


bx, 2 

di 

paraout 

short install 


di,offset line 
dh, 24 
pareval 


di,offset column 
adh, 75 


bx 
dx 
asciibin 
ax 
bx 


badpara 

ah,ah 

badpara 

al,dh 

badpara 
{di],al 

short nextpara 


dx,offset allinm 
short noinerr 


dx,offset badp 
al,l 
showend 


extkey, 0 
badpara 
ax, 3516h 
21h 


° 
if 


me TS 


Key code discovered? 
7YES --> Error 


;save Pointer in PARTAB 

7;save remaining number of Parameters 
zset SI to beginning of number 
sconvert Code to binary 

7get remaining number of Parameters 
7get Pointer in PARTAB 


7no number found <--> Error 
snumber larger than 255? 
7;YES --> wrong number 
number o.k. record it 
announce Key code discovery 


7Address of the next PARTAB-Element 
;decrease Parameter counter 

jlast Parameter? NO --> continue 
7Parameter o.k. --> install program 


;Address of Line-Variable 
;Maximum value for Line 
7evaluate Parameter 


;Address of the Column-Variable 
;Maximum value for column 


zstore Pointer in PARTAB 

7store remaining number of Parameters 
sconvert Code to binary 

sget remaining number of Parameters 
7;get Pointer in PARTAB 


sno number found --> Error 
sNumber larger than 255? 

7YES --> wrong number 

sNumber larger than permitted? 
7YES --> wrong number 

7Number o.k. therefore store 
7evaluate next prameter 


;Error-Message: already installed 
youtput Error-Message and terminate 


;Error-Message: invalid parameter 
7 Error-Code 
;terminate program 


Key-code discovered? 

z7;NO --> Error 

zget content of interrupt vector 16 
7call DOS-function 
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cmp word ptr es:([bx+2],"“TM" ;test if already installed 


je allinst 7;YES --> Error 
mov intaltseg,es ;segment and offset address of the 
mov intaltofs,bx ;stored-interrupt vector 16 (h) 


mov dx,offset newint ;Offset address new interrupt routine 
mov ax,2516h ;change content interrupt vector 16 
int 21h ;to user routine 


mov dx,offset installm ;Message: program installed 
mov ah,9 youtput function number for string 
int 2inh 7call DOS-function 


7-- only the PSP, the new interrupt-Routine and the ---------- 
7-- Data must remain resident. 


mov dx,offset instend ;calculate number of paragraphs 
mov cl,4 ; (each 16 Bytes) at the disposal 


shr adx,cl of the program 

inc dx 

mov ax,3100h sterminate program with End-Code 0 

int 21h ;remain resident 
showend: mov. ah,9 ;output string 

int 2lh ;call DOS~function 

mov ah,4Ch 7function number for program 

int 21h ;terminate program with End-Code 
showinit endp ;End of PROG-procedure 


-~ ASCIIBIN: convert ASCII number to binary (max. 16 Bit) ------------ 
-- Input : DS:SI = Address of Number as ASCII-string 


z—-—- Output AX = the converted Number 

7-- Carry-Flag = 1 : Number too large 

7-- Register : AX, BX, CX, SI and FLAGS are changed 

7-- Info : the ASCII-string must be ended with Code 0 


asciibin proc near 


xor bh,bh sHi-Byte of every position 
mov cx,10 zwe use decimal system 
XOY ax,ax ;preliminary result 

nx num: mov bl, [si] ;get next number 
or  bl,bl ;NUL-Code (End) ? 
je ab ende 7YES --> number converted 
cmp bl, “0" stest if number 
jb ab ret 7;NO --> Error 
cmp bl,"9" ztest if number 
ja ab err :NO --> Error 
mul cx zpreliminary Number * 10 
jc ab ret ;Number > 65535 --> Error 
and bl,1111b ;convert number to binary 
add ax,bx zadd to preliminary Number 
inc si 7process next number 


jmp short nx _ num 


ab ende: clc 7no Error 

ret ;back to caller 
aberr:  stc Error 
ab_ret: ret rback to caller 


asciibin endp 


-- PARMTEST: capture Parameter in the Command Line --~--------------- 
Input : DS:0000 = Address of PSP 

Output : DL = number of parameters found 

-~- Register : AX, CX, DX, SI and FLAGS are changed 


me Me Me Me 
| 
I 
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Address of every parameter is stored in Array-PARTAB as 
Offset address to DS. In addition behind every 


parmtest proc near 


cld 
xor 
Mov 


mov 
or 


je  parmtend 


inc 
xor 
getez: lodsb 


cmp al, te oe 


je 
cmp 


je 


si, 80h 


cl,byte ptr [si] 


cl,cl 


si 
ch, ch 


space 


al, TAB 


space 


-— parameter an ASCII-Code 0 is stored. 


zon string commands count up 

snumber of parameters found 

gaddress where number of characters 
;0of the command line is stored in PSP 
sget number of character 

;have parameters been passed? 

7NO --> End 


7SI points to start of command line 
zin CX is the number of characters 
smove next character to AL 

zis it a space ? 

7;YES --> SPACE 

gis it a Tab-character? 

7YES --> SPACE 


f-= no Space “or Tabulator. ---a-—=s< se 


inc 
not 


dh, dh 
next Z 


dl 
dh 


mov ax,si 


dec 
stosw 


ax 


next z: loop getez 


mov byte ptr [si],0 


parmtend: ret 


space: or 


je 


7-- found next parameter 


mov byte ptr [si-1],0 
short nextz 


Program flow 
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dh, dh 
nextz 


dh, dh 


;was last character space ? 
7NO --> process next character 


z;increment number parameters found 


jindicates no “ " or TAB 
;Ccalculate address of 
;parameter 


;store in parameter-Table 


7get next character 
7NUL-character as parameter-End 


;back to caller 


jwas last character space character? 
7YES --> process next character 


;this character was a space 
;NUL-character as parameter-End 
;process next character 


7End of CODE-Segment 


The file header describes the DOS call of the program. As mentioned above, there 
are two basic options for the call: If you call the program without parameters in 
the command line, it tries to remove any previously installed SHOWCLK. If you 
call the program with parameters, SHOWCLK installs itself. The first parameter 
must be the scan code which the user wants to trigger the clock display. The line 
and column parameters indicate the clock display area on the screen. If these two 
parameters are missing, the clock appears in the upper right hand corner of the 


screen. 
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The constant definition follows the file header to ease your reading of the listing. 


The code segment definition follows, which accepts the program code and the data. 
The ORG 100H instruction, which places the beginning of the program at address 
100H, indicates that SHOWCLK is a COM program. A COM program is a good 
choice for a resident interrupt driver because of the compactness of having data, 
code and stack in one segment. 


The label START shows the first executable instruction of the program. It jumps 
first to the installation routine of SHOWCLK which has the name SHOWINIT. 


This routine loads the address of a table and calls the procedure PARMTEST. It 
counts the number of arguments passed in the command line and stores the starting 
addresses of the individual parameters into the passed table. After this procedure 
ends, SHOWINIT tests whether parameters were passed in the command line. If 
this is not the case, it jumps to DEACTIVATE which removes the old 
SHOWCLK from memory. 


Assuming that arguments were passed to SHOWCLK in the command line, 
SHOWINIT now reads the passed parameters and tests them for accuracy. If it finds 
a correct key code, this code passes to the KEYCODE variable. If the indication of 
a line or column is found, it's tested for an acceptable value. If YES, it moves to 
the COLUMN or LINE variable. If an error and unknown parameter or an illegal 
coordinate occurs during the argument checking, the program ends with an error 
code. If the parameters evaluated are correct, a jump goes to the label INSTALL. A 
test searches for a keyboard code. If no keyboard code exists, the program ends with 
an error message. If it's available, the program first tests if SHOWCLK is already 
installed. 


DOS function 35H determines the address of the BIOS keyboard interrupt (the 
interrupt pointing to a user routine). It returns the segment address of the interrupt 
routine in ES, and the offset address in the BX register. If SHOWCLK was already 
installed, an interrupt routine must be located at this address which is constructed 
exactly like the interrupt routine which is installed, since SHOWCLK always 
installs the same interrupt routine. 


The routine starts with a 2-byte jump instruction to the routine itself. An 
identification code follows, consisting of two ASCII characters, which can be the 
initials of the author. In this case the initials are MT. INSTALL tests the address 
of the interrupt routine plus 2 for the ASCII codes of the initials MT. The test is 
not for MT, but for TM, since the low byte is always stored before the high byte. 
If the code exists, SHOWCLK is already installed and the program terminates with 
an error message. If INSTALL finds another bit pattern, it means that no previous 
version of SHOWCLK existed. INSTALL can then proceed with installation. 
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Installing SHOWCLK 


First INSTALL stores the address of the old interrupt routine in the INTALTOFS 
and INTALTSEG variables. Next the interrupt 16H points through DOS function 
25H to the NEWINT routine. The new interrupt routine of interrupt 16H is called 
if a program wants to call one of the three functions of this interrupt. A message 
tells the user that the program is now installed, and the DOS prompt returns. It's 
important that DOS not release the memory occupied by SHOWCLK for other 
programs. This could result in another program overwriting the new interrupt 
routine, and a system crash during the call of interrupt 16H. To prevent this, the 
program terminates with a DOS function which makes a portion of this program 
resident and prevents overwriting by other programs. Function 31H must be 
informed how many 16-byte paragraphs must be protected, starting from the 
beginning of the PSP. 


Protecting memory 


Once installed, the new interrupt routine must stay protected from changes that 
other registers could make to it. At the same time, SHOWCLK's installation 
routine must remain unprotected. SHOWCLK places the interrupt routine before 
the installation routine. Only the number of bytes between the beginning of the 
PSP and the last byte of the interrupt routine, converted into paragraphs, must be 
passed to function 32H. The new interrupt routine cannot be overwritten. 


This interrupt routine must also contain variables. They are stored between the 
program start instruction and the interrupt routine code proper. This ensures that 
the variables remain resident in memory. At the beginning of the interrupt routine 
(NEWINT) is a jump instruction followed by the identification code. When a 
program calls interrupt 16H, a jump occurs directly to label NEWI_1. NEWI_1 
tests for whether the function number passed to interrupt 16H in the AH register is 
0. This is the only function applicable to this program, since the function reads 
characters from the keyboard buffer. If you called one of the two other functions, 
the program calls the old interrupt 16H and passes control to the calling program. 
If function 0 is called, it reads a character from the keyboard with the old keyboard 
interrupt. The program then compares this character with the key indicated when 
the program call occurred. If this is not the case, control returns to the calling 
program. If it was the indicated key, preparations begin to display the time on the 
screen. 


Stack activity 
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First the contents of all registers which change during the course of the program 
are stored on the stack so they can be restored to the calling program. Then the five 
characters of the display in the position where the time appears are read from the 
screen and stored. DOS function 2CH reads the time and converts it to an ASCII 
string for display. After the time appears on the screen, the old keyboard interrupt 
waits for a keypress. When this occurs, the characters formerly located where the 
time appears return to their old positions. The registers return from the stack and 
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the program jumps to the beginning of the routine to read in a key, display the 
time again, or pass the key to the calling program. 


Deactivating SHOWCLK 


The last component to be examined is the program routine called when 
SHOWCLK is removed from memory. The installation routine calls it if no 
parameter was passed in the command line and begins with the DEACTIVATE 
label. The routine tests for whether SHOWCLK is already installed. If this isn't 
the case, it cannot be removed, and the program terminates with an error message. 
If SHOWCLK was already installed, the keyboard interrupt must point to the old 
interrupt routine. The memory containing the old SHOWCLK routine must be 
released. 


The problem is that the new SHOWCLK, which should remove the SHOWCLK 
already in memory, doesn't know the address of the old interrupt routine of 
interrupt 16H. It's stored in the old SHOWCLK in the variables INTALTOFS and 
INTALTSEG. The two variables are in completely different programs, but there is 
a simple method of reading these variables. The old SHOWCLK lies in a different 
memory segment from the new SHOWCLK, but the offset addresses of the 
variables and routines in both programs are identical. Since you know the segment 
address of the old SHOWCLK (the segment address of the interrupt routine), the 
contents of the variables INTALTOFS and INTALTSEG can be read from the old 
SHOWCLK and the interrupt 16H can again point to the original interrupt routine. 
Memory can be released again through the segment address of the old SHOWCLK 
routine with the help of DOS function 49H. This concludes the task of 
DECACTIVATE and the program can terminate after displaying a message. 


Examine the listing step by step and read the comments carefully. This is 
important, because the program can serve as a basic framework for any resident 
interrupt driver. We'll discuss another form of resident program (the TSR 
program) in Chapter 8. 
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7.12 Accessing the Printer from the BIOS 


BIOS offers three functions, called by interrupt 17H, for communicating with one 
or more printers interfaced to the PC. These functions have an advantage over the 
DOS printer output functions: They can specify the printer to which the output 
should go. The printer's number (0, 1 or 2) must be loaded into the DX register 
during the function call. After each of the three function calls, the printer status 
passes to the AH register. Each bit in this status byte provides information about 
the printer's task, whether it still has paper, etc. 


7 6 5 4 3 +2 =#421 QO bit 
1=Time out error 


1=Printer ONLINE 
O=Printer OFFLINE 
1=Printer out of paper 


1=Receive mode selected 
O=Printer busy 


Printer status byte 


Time out 
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A time out error occurs when BIOS tries to send data for a certain amount of time 
to the printer, but the printer refuses the data and returns a busy message (bit 7 
becomes 0). The number of tries BIOS makes before signaling a time out error 
depends on the contents of address 0040:0078 in RAM. ROM uses this address for 
storing variables. The value 20 which BIOS enters into these memory locations 
during the system boot is different from the repeat factor of 20. The value in these 
memory locations must be multiplied first by 4, then by 65,536. A value of 20 
actually refers to 5 million attempts. This number is relative since the loop which 
checks the printer has only a few assembly language instructions processed very 
quickly by the CPU. This results in a waiting period of only a few seconds before 
the BIOS reports a time out error. If working with the BIOS routine seems to 
create more time out errors than usual, try increasing the value in the memory 
locations mentioned above so that BIOS makes more attempts. This may ne 
communication between BIOS and the printer. 


Various printer conditions can change a series of bits in the status byte. An ON 
LINE (ready to print) printer sets bits 7 and 4. If the printer switches to OFF LINE 
(e.g., for page advance) then bit 7 and bit 4 reset and bit 3 sets, indicating a 
transmission error. 
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The program must decide whether new data should be sent to the printer, whether 
printer output should end or further steps should be taken. 


Function 0: Send character 


Function 0 transmits a character to the printer. Load the function number into the 
AH register and the ASCII code of the character you want sent into the AL 
register. After the function call the AH register contains the status byte. If the 
character transmission/printing failed, the AH register contains the value 1. 


Function 1: Initialize printer 


The second function initializes the printer ports. You should always execute this 
function before sending data to the printer for the first time. Load the function 
number 1 into the AH register; no other arguments are required. 


Function 2: Read printer status 


Function 2 loads the status byte into the AH register. As mentioned above, the 
Status byte tells you the current status of the printer. Load the function number 2 
into the AH register; no other arguments are required. 


Demonstration programs 


The programs listed in this section use the BIOS printer interrupt in the same way 
as the programs listed earlier to demonstrate the BIOS keyboard interrupt. The 
three higher level language programs listed here send strings to a printer using the 
BIOS printer interrupt. The fourth program is an assembly language routine which 
adapts the BIOS printer interrupt to its own routine. 


The three higher level language programs are similar in organization and are 
divided into five sections. One section is the main program. The other four 
sections call the various functions of the BIOS printer interrupt. These sections 
include a routine for initializing a specific printer interface, a routine for character 
or string output and a routine which displays an error message on the screen if 
needed. The main program initializes printer interface 0, then prints a test string on 
the printer connected to this interface. If an error occurs during one of these two 
operations, an error message is displayed on the monitor. This message can be 
delayed if no printer is attached to the PC, since BIOS continues addressing the 
printer, and gives up after a few attempts. If nothing happens for some time, don't 
panic. The program will eventually report its error status. 


385 


7. The BIOS PC System Programming 


BASIC listing: PRINTB.BAS 


100 CRM KAI KAKIKKIKK IKEA AKER KEKE KEKREEKKKE | 


110 ‘* PRINTB aia 
120 8 Pe ase caus cm wees wes eore ween een ene sas etn cen Se cen Mets Sn te CO EN Ce ED ED AD SD ED SE ED OED QUED SO DS CED DSA SAD EAE SD GSD ED ED CAD SD OS GAY IU DCD ID ND ED SD UN SEND cn Cu CN REP HER «A 
130 ** Task : makes a subroutine available for sending =A 
140 '* strings to a printer and * 
150 ‘* registering errors during the output to the *' 
160 '* printer ae 
170 ** Author : MICHAEL TISCHER ae 
180 '* developed on = : 7/22/87 * 
190 '* last Update : 9/21/87 it 
200 UR KKKKKHKEKREKKKKKKKEEKKEKKEKKKK KE KKEKKKKEKKKEKEEKKKEKEKEKEKKKKKKEKE I 


210 ° 

220 CLS : KEY OFF 

230 PRINT"WARNING: This program should be started only if GWBASIC was “ 
240 PRINT"started from the DOS level with <GWBASIC /m:60000>.* 

250 PRINT : PRINT"If this is not the case, please input <s> for Stop." 
260 PRINT“Otherwise press any key..."; 

270 AS = INKEYS : IF A$ = “s" THEN END 

280 IF AS = "" THEN 270 

290 GOSUB 60000 ‘install Function for Interrupt-Call 

300 CLS ‘Clear Screen 

310 PRINT“PRINT (c) 1987 by Michael Tischer" : PRINT 

320 PRINT"If a parallel printer is interfaced to your PC, the “ 

330 PRINT" following text should appear on it immediately:" : PRINT 

340 PRINT"a test of the printer routines..." +: PRINT 

350 PRINT“"If not, an error message will be output." : PRINT 


360 PRINTERS = 0 ‘address the first Printer on the PC 

370 GOSUB 50000 ‘initialize Printer 

380 GOSUB 53000 ‘output message 

390 TS = "a test of the printer routines..."+CHR$ (13) +CHR$ (10) 

400 GOSUB 51000 ‘output String on the Printer 

410 GOSUB 53000 ‘output Message 

420 PRINT 

430 END 

440 '! 

50000 OHHH HK TKI KKK KK KKK KKK KEK KKK KEK KKK KKK KKKKKKKEKEK 
50010 '* initialize one of the Printer interfaces xs 
50020 8 Ramm a a rn er eran ii 
50030 '* Input: PRINTER% = the Number of the Printer to be addressed *' 
90040 '* Output: DS% is the Status of the Printer ms 
50050 '* Info : the Variable 2% is used as Dummy a 
50060 CHM KK KK KKK EKKEKKEKEKKKKKEKKKEKKKEKKKKEKK KEKE KEEKKEKEKEKKKKKEKKKKKEKS 
50070 ! 

50080 PRTHI% = 0 ‘Hi-Byte of the Printer number 

50090 FKT%=2 ‘initialize Function number for Interface 
50100 INR%=&H17 ‘call BIOS-Printer-Interrupt 17 (h) 

50110 CALL IA(INR%, FKT%, 2%, 2%, 2%, 2%, 2%, PRTHI%, PRINTER%, 2%, 2%, 2%, 2%) 
50120 DS%& = FKT% AND &H21 ‘store Printer status in DS% 

50130 RETURN ‘back to Caller 

50140 ' 

51000 CHK KKKE KKK KKK KEKKEKKKKKKEKEKKKKKEKKKKEKKKKKKEKEKEKEKKEEKEKKKKEKEKKK 
51010 '* send a String to one of the Printers ws 
51020 '*----~~-~-~~—-~—-—~--+~-------—- - - -- - - - - - $n nnn xe 
51030 '* Input: T$ = the String to be output a 
51040 ‘* PRINTERS = the Number of the Printer x 
51050 '* Output: the Variable DS% contains the Printer status iad 
51060 CHR KKRKKKKEKEKEKEKEKEKKEKEKEKKEEKEKKEKEKKEKKEKKEKKKEKEKKKKEEKEKEKKKEK 
51070 ! 

51080 FOR I = 1 TO LEN(TS) ‘process all characters of the string 
51090 Z$ = MIDS$(TS,I,1) ‘isolate one character from the string 
51100 GOSUB 52000 ‘output character on the printer 

51110 IF DS%<>0 THEN I = LEN(TS) ‘on error terminate output 
91120 NEXT I ‘process next character 

51130 RETURN ‘back to Caller 

51140 ° 

52000 CREEK KKKEKKEKEKEKEKEKEKKEKEKKKKAEKEKEKKEKEKEKEKKEKKEKREKKKEKKKKKKKKK 
52010 '* send a Character to one of the Printers ** 
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52020 '!*--------------~-~------ - -- — -- - nr ne xe 
52030 '* Input: 2Z$ = the Character to be output * 
52040 '* PRINTERS = the Number of the Printer we 
52050 '* Output: the Variable DS% contains Printer status (0=o0.k.) as 
52060 '* Info : the Variable 2% is used as a Dummy we 
52070 CHK KKK KR KEKE KKK EEK KKK KEK KEEKKKKK KEK KKEKKKEKKKKKKEKKKEKKKKKKEK 
52080 '! 

52090 CHARACTERS = ASC (Z$) ‘the ASCII-Code of the Character 

52100 FKT%=0 ‘print Function number for Character 
52110 INR%=&H17 ‘call BIOS-Printer-Interrupt 17 (h) 

52120 CALL IA(INR%, FKT%, CHARACTERS, 2%, 2%, 2%,2%, PRTHI%, PRINTERS, 2%, 2%, 2%, 2%) 
52130 DS% = FKT% AND &H21 ‘record Printer status in DS% 

52140 RETURN ‘hack.co Calter 

52150 ! 


53000 OCHRE KKK KKK KKK KEK KKK KKK KKEKKEKAKKKKKKKKKS 
53010 '* Output an error-message on the basis of the Printer-Status *' 


53020 8 Ramm mn a a a a err rn a 
93030 '* Input: DS% = the Printer status xe 
53040 ** Output: none as 
53050 ‘* Info : if the Printer status is o.k., no output a 
53060 CHM KKKKKKKKKKKKEKKKKKKKKKKEEKKKKKKEKEKKKEKKK KEK KKEKKKEKKKEKKKKEKKS 
53070 ! 


53080 IF DS&% = 0 THEN RETURN ‘everything o.k. --> back to Caller 
53090 PRINT“Error on access to Printer: "; 

53100 IF (DS% AND 1) <> O THEN PRINT"Time-Out-Error" : RETURN 
53110 IF (DS% AND 8) <> 0 THEN PRINT"I/O Error" : RETURN 


93120 IF (DS% AND 32) <> O THEN PRINT"no more paper “ : RETURN 

53130 PRINT"Error type unknown" : RETURN 

53140 ! 

60000 UR KKKKKKKKKKKKKKKEKKEKKKKKKKKKKKKKKKKKKKEKKEKKEKKEKKKEKKEKKKKKKEKEKEKEK 
60010 '* initialize the Routine for Interrupt-Call s 
60020 !'*-~----------~----—~--—- - - re =e 
60030 '* Input: none iia 


60040 '* Output: IA is the Start address of the Interrupt-Routine old 


60050 CR KK KKK KKH K KKK KKK KKH KEKE KK EKER KKK KEKE KKK KEEKKKKKKKKK 


60060 ! 
60070 IA=60000! ‘Start address of the Routine in the BASIC-Segment 
60080 DEF SEG ‘set BASTC-Segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke Routine 
60110 RETURN ‘back to Caller 

60120 ' 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,136, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 
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{ PERAK K KKK KEKE KKK KKK ERE KRK KKK KEKE KKEKEKRKEKE KEKE KKK KKEKEKEKEKKKEKRKEKKESE } 


{* PRINTP *} 
{* si es Ss sn wim tS sen Se Sst ss srs ems ec cei cn Sime eo bw Shinar i St ins Si sn ois’ oi a Sen Se och eo ci sees exam is sn cs ws so a *} 
{* Task : Makes a function available for sending *} 
{= . strings to a printer and registers *} 
{* errors during the output to the printer *} 
{* ‘mS acm ci cow n> Sas > ae > i Semen i wos co es i's i ei mb mh, eS Sib sine vin i rsh cs i vv win ii ml iain i sino mn Sti i si cess sus imi bt eu Stes ois *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 7/9/87 wy} 
{* ‘last Update : 6/09/89 *} 


{RRR IK KHER IKK IK HR RIKKI KEKE RAKE RE KAI ER ERK KEKE KK KE | 


program PRINTPP; 

Uses Crt, Dos; { Add Crt and Dos units } 
{SV-} { Don't test string length } 
type Output = string[255]; 


var PrintError : byte; { Printer error code } 


[BARRE RRR HK KKK KERIKERI KEIR KAKA KKKERK EEK KIRKE KKAKKKKAKKKKAKE | 


{* PRINTCHARACTER: sends a character to the printer *} 
{* Input : see below *} 
{* Output : TRUE if an error occurred, else FALSE *} 
{* Info : if an error is discovered, the status of the printer is *} 
{* stored in the global variable PRINTERROR *} 


{ BERRA RRR KR RRR KERRI KKK ERKKKKIKKEKHKRIKKEKEKEKKKKEKKE EKER IKKE KKK KEK KKK KE } 


function PrintCharacter (Character : char; { Character to be output } 
Printer : integer) : boolean; { Nr. of Printer } 


var Regs : Registers; { Register variable for interrupt call } 
begin 
Regs.ah := 0; 
Regs.al := ord (Character); { Function number & code of character } 
Regs.dx := Printer; { Printer. number } 
intr($17, Regs); { Call BIOS printer interrupt } 
if (Regs.ah and $21) <> 0 then { Did an error occur? } 
begin { YES } 
PrintCharacter := false; { Display error } 
PrintError := Regs.ah; { Record error code } 
end 
else PrintCharacter := true { No error } 
end; 


{FARRER RE EKER EKER EK ERE KERR EK ERE REE KEK ERE KEK KKERKEK EKER EKKEKEEEKEKEK KE | 


{* PRINTSTRING: sends a string to the selected printer *} 
{* Input : see below *4 
{* Output : TRUE if no error occurred, else FALSE *} 


{ BERR RRR RRR KEK RRR RR KKK KKK KKK EKER ARK EKK KKK KR RKE KEK K EK KKK KREKKEEKEKK KKK KK 


function PrintString (Text : Output; { the string to be output } 
Printer : integer} : boolean;{ Number of printer } 
var Counter : integer; { loop counter } 
Ok : boolean; { Result of the PRINTCHARACTER function } 
begin 
Counter := 1; { begin with the first character in the string } 
repeat 
Ok := PrintCharacter (Text [Counter], Printer); { Print a character } 
Counter := succ(Counter) { Process next character } 
until not (Ok) or (Counter > length(Text)); { Terminate on error } 
PrintString := Ok; { Set result of the function } 
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end; 


{RHE RKKARHRKHRREKKKEK ERE EKKERERKEKEK ERE RIKER KER ERKEKKE RK KKEKEKKKEKKEKKKKKEE | 


{* INITPRINTER: initializes the printer interface *} 
{* Input : see below *} 
{* Output : true, if no error occurred, otherwise false *} 
{* Info : if an Error is detected, the Status of the Printer is *} 
1% stored in the glqbal Variable PRINTERROR *} 


{ RAI K HRI RIKKI KKK KIKI IK IKK IIR KKK KIRK KKK KEK KKK EK KEKE KEKEKEKEKEKEKEE } 


function InitPrinter (Printer : integer) : boolean; { Printer number } 


var Regs : Registers; { Register variabies for interrupt cali } 
begin 
Regs.ah := $2; { Function number for Init } 
Regs.dadx := Printer; { Printer number } 
intr($17, Regs); { Call BIOS printer interrupt } 
if (Regs.ah and $21) <> 0 then { Did an error occur ? } 
begin { YES } 
InitPrinter := false; { Display error } 
PrintError := Regs.ah; { Record error code } 
end 
else InitPrinter := true { No error } 
end; 


{ BAAR RAEKKRKEEKKEKRKEKKEKEKKEKRERKKKRAEKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KEY 


{* PRINTERROR: outputs error message *} 
{* Input : none *} 
{* Output : none *} 
{* Info : the error message is displayed according to the content *} 
{* of the variable =} 
{* PRINTERROR *} 


{ RA RRKARKKAEKK KK EKER KK KEK KEK KEKE KEK KEKKE KKK KK KEKE KKK KEKE KKKKKKKEKKKKKEK KE | 


procedure PrinterError; 


begin 

write(‘Error during printer access: '); 
1f PrintError and 1 <> 0 { Time out error? } 
then writeln('Time-Out Error') { YES } 
else if PrintError and 8 <> 0 { I/O error? } 
then writeln('I/O Error') { YES } 
else if PrintError and 32 <> 0 { No more paper ? } 
then writeln('tout of paper') { YES } 


else writeln('Error unknown'); 
end; 


{ RRR RRR RRR KHER RK K RRR RK KKK KEK KKK KKK RIK EK KKK EKER KEK KKK KEK EKKKEKKEKKEKE | 


{* MAIN PROGRAM *} 


{ FARRAR RK KKK KERR RK KKK KEKE KK KKK KEK KEKE KKK KK KKK KKK KEK KKKKKKKKKKEKKEKKKKKKE | 


begin 
clrscr; { Clear screen } 
writeln('PRINT (c) 1987 by Michael Tischer'); 
writeln(#13#10‘If a printer is interfaced to the parallel interface ‘+ 
'O of the PC, '); 
writeln('the following text should now appear on this ‘+ 
"printers "}; 
writeln(#13#10'a test of the printer routines...'#13#10); 
writeln('Otherwise the program will display an error message !'); 
writeln; 
if InitPrinter(0) then { Initialize printer interface 0 } 
begin 
if PrintString('a test of the printer routines...'#13#10, 0) 
then writeln(‘all o.k.') 


else PrinterError { display error message } 

end { Initialization error } 

else PrinterError; { display error message } 
end. 
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C listing: PRINTC.C 


[RAKE HIRI IRRE IRE IKI KIRK IKKE IKI IKARIA AERA EKAAK KE | 


/* PRINTC */ 
/* scan ssi ses i se d'eau mi em ee mh a it i li va si oe ek i sii cp a is iil Sn a Sli tm ii Ws io Sa: i sn ee os ei Sr Si Ss x/ 
/* Task : Makes a function available for sending a */ 
/* string to a printer. If any errors occur */ 
/* during printing, the program will display */ 
/* errors on the screen */ 
/* sci om stn ls asics sis nai ks ibs sy wim nin es sus tm sms i as cos cn mie Sas ise mG Si ui a ces a cel i si! is is tc nun ncn Sin ci ecw em ein a/ 
/* Author : MICHAEL TISCHER */ 
/* developed on : 8/13/87 */ 
/* last update : 6/09/89 */ 
/* eons sc i cis sca cn in is se ap cas cs ci cs ns cei nists‘ i sso ie sm ellen as ie es ms Su’ dn cams cs enn tu ck Sie lw mses sel nin Se Si Sdn QS ams im */ 
/* (MICROSOFT C) =), 
7* Creation : MSC PRINTC s/f 
Z* LINK PRINTC; */ 
/* Call : PRINTC «/ 
/* cn sem ssi‘ <ous Gam ish nn oss arm sn sirens nao inns ences in a cm ees ch ec ce Ss Aco as coco Sw mn cn Sm ps es cas ian cas ce ses re es ete ee Sa sm tees ee x/ 
/* (BORLAND TURBO C)} =] 
/* Creation : with the RUN command in the command line x} 


SJ RRR REE KIRKE KEK EK KIRK KIKI KIRKE KKK EEK EKER KE KEKE KKK KKK KEKE / 


#include <dos.h> /* include header files */ 
#include <io.h> 


typedef unsigned char byte; /* Create a byte */ 
#define FALSE 0 /* Constants make reading of the */ 
#define TRUE 1 /* program text easier */ 
[RRR KEK EKER KRER EK KEK KKK KEK EKER KEKE KKK KEK KEKE KK KKK KEKE KEK KEKKEKEKEEKKKKE / 
/* PRINTERROR: displays error message */ 
/* Input : O stands for o.k., else error code "7 
/* Output : TRUE if no error is displayed, else FALSE a7 


[BERRA IER KEK KKK KKK AKER KEKE KKK KKK KE KEKE KEKE KKK AKEKKEKEKE / 


byte PrintError (Status) 


int Status; /* Printer status */ 
{ 
if (Status) /* Did an error occur ? */ 
{ j /* YES */ 
printf("Error during printer access:"); 
if (Status & 1) /* Time-Out Error? */ 
printf ("Time-Out Error\n") ; /* YES */ 
else if (Status & 8) /* I/O error? */ 
printf ("I/O error\n"); /* YES */ 
else if (Status & 32) /* No more paper ? */ 
printf("no more paper\n") ; /* YES */ 


else printf("Error unknown\n") ; 
return (FALSE) ; 
} 
else return (TRUE); . /* Error detected */ 
} 


[RRR KKK IKKE IK KKK KKK EKK KKK KEIR ERK KEK KEKE KEK KEK KKK KEKE KKK KEKKKEKEEKKK / 


/* PRINTCHARACTER: sends a character to the printer np 
/* Input : see below xs 
/* Output : FALSE if no error occurred, else aA 
{* error number =f 


[RAK KKK KIKI KK IIH IK KIKI IKK III IK KIKI KIKI KIKI KIRKE KEAIAKKEEAKAKKKKAK KKK / 


byte PrintCharacter(Character, Printer) 
char Character; /* The character for output */ 
unsigned int Printer; /* Number of the designated printer */ 


{ 
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union REGS Register; /* Register variables for interrupt call */ 
Register.h.ah = 0; /* Function number for character printing */ 
Register.h.al = Character; /* Character code */ 
Register.x.dx = Printer; /* Printer number */ 
int86(0x17, &Register, &Register); /* call BIOS printer interrupt */ 
return (Register.h.ah & 0x29); /* Leave only error bits */ 


} 


[RI IIH IIR TIKI KKK IKK HRT RR KKK IKE KIKI K KK IKKE KEKE KKK KKK KKK / 


/* PRINTSTRING: sends a string to the selected printer ua 
/* Input : see below */ 
Ie Devt wine oe FAT en TE RnR Rew RS RR RISK a alen x/ 
‘ wie vue e Aug ate 8 Cheyer VEE ULI, euiSct ‘ 
[* error number af 


[RII KIKI III KIKI IKI IKI KKK KKK IKK HIKE IKK KIKI KKK IKK KKK KKK IKK KI / 


byte PrintString(Text, Printer) 


char *Text; /* String to be output (character vector) */ 
unsigned int Printer; /* Number of the printer */ 
{ 

byte Status; /* The printer status */ 
Status = FALSE; /* Initialize if string is empty */ 


/* Output string until end is reached or error occurs during output*/ 
while (*Text && ! (Status = PrintCharacter (*Text++, Printer) )) 


e 


return (Status); 


} 


[RR KAKIAKRK IRE KKK IKI KIRK KEKE KKK KAKI KK KKK KK KEE KEKE KKEKKEKRK KK KEKKKEAKE 


/* INITPRINTER: initialize the printer interface a 
/* Input : see below +7, 
/* Output : FALSE if no error occurred, else */ 
/* error number x/ 


[RII IK IK IK IKI IK KIKI IK TKK IK IK IK KKK KHIR IKI KIKI KHIR IEK IKK KKK KKK / 


byte InitPrinter (Printer) 


int Printer; /* Printer interface to be initialized */ 
{ 

union REGS Register; /* Register variables for interrupt call */ 
Register.h.ah = 2; /* Function number for Init */ 
Register.x.dx = Printer ; /* Printer/interface number */ 
int86(0x17, &Register, &Register); /* Call BIOS printer interrupt */ 
return (Register.h.ah & 0x29); /* Leave only error bits */ 


} 


[RRR KKK KKK RIKKI KEK IKK KKK ERK KERR EIR IKK IKK KIKI KEK IKK KEK KEK KEK KKK / 


pe MAIN PROGRAM iy 6 
[RR RRR KEK IK IIR RRR IKK RIK IKI KR RIK IK RK IKI TIKI KIKI RK IK KKK / 


void main() 


{ 
printf("\nPRINT (c) 1987 by Michael Tischer\n\n"); 
printf("If a parallel printer is interfaced to this PC\n"); 
printf(" the following text should appear soon:\n\n"); 
printf("a test of the printer routines...\n\notherwise "); 
printf("an error message is displayed on the monitor screen.\n\n"); 
if (PrintError (InitPrinter (0))) 
PrintError (PrintString("a test of the printer routines...\r\n"),0); 
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The assembly language program listed below is a resident interrupt driver. It can 
help the user whose printer runs a character set other than the PC standard. This is 
true of some Epson printers, whose foreign characters are different from the PC 
ASCII character set. The program converts these characters before sending them to 
the printer by turning the BIOS printer interrupt to its own routine, which is called 
every time the BIOS printer interrupt is called. 


It tests for whether or not function 0 (character output to a printer) should be 
called, because only this function changes. If not, the call passes to the old printer 
interrupt. 


If a character should be output, the interrupt looks into a table, with the name 
CODETAB, for the character. This table consists of 2-byte entries. The first (low) 
byte contains the new code of the character to be converted. The second (high) byte 
contains the old character code. The table ends with a byte containing the value 0. 


The routine checks the second byte of a table entry if it is identical to the character 
to be printed. If the character cannot be found in the table, it passes unchanged 
through the old printer interrupt for output. If the character exists in the table, it is 
replaced by the first byte of the current entry, then sent for output using the old 
printer interrupt. 


This program has a similar structure to the resident keyboard interrupt driver 
presented in Section 7.11. The main difference between the two programs lies in 
the command line, because PRUM (the program listed here) doesn't pass any 
parameters. It tests for an existing pre-installed version of itself when it is called. 
If no installed PRUM routine exists, it installs itself. Otherwise the installed 
version loads from disk or hard disk. 


This program can transmit output to the printer using the BIOS printer interrupt as 
well as DOS. 


Assembler listing: PRUM.ASM 


392 


SHKKKKKKKKKEKKKEKKKKKKEKKKKKKKEKKKKKKKKKE KKK KKKKKHAKKKKKAEKEKKKKKKKKKKKKKKKKe 


f t 
:* P RUM Se 
7* a: ae ce Sw ects nau “cme en eben escent cs cis seis“ sin ‘cas Sims ee osc “Srw cml Mcnamara nme sou ts cm es eos eas ew eee cs es sn ee we 
ox Task : Points the BIOS printer interrupt to its own * 
hy Routine and makes it possible for example ws 
rites to convert IBM-ASCII to EPSON. a 
ee The program is deactivated again on the a 
ae second call and removed from memory. tebr 
(0 cee les ‘ces en sm lems ‘alo cae an sts Sais eres es mls ces ee ins ca ea ees wl cigs os ad cms eens seme Soe as cesT ed es ves Sinn See dca em ices cts cas ae cess is es “eh i wes Se es ko 
;* Author : MICHAEL TISCHER *; 
: developed on : 8/2/87 * 9 
;* last update : 6/09/89 a 
;* is Sa css ‘Ssh ‘ces sao “aids em tir’ es ces ams“ ini nis han‘: san} nn casa es: esc‘ nD cus sad es i‘ es Sms ob a Sick am cans “ts mts ss Se nk savin ems Gal's ten ss xs 
a. assembly : MASM PRUM; *s 
a LINK PRUM; *s 
7% EXE2BIN PRUM PRUM.COM *; 
;* sass (coe cm ‘mm ca ‘ey anid ts OOS enn emi eas cas ems e/a ae Gas ‘cas mem Som eis wis sav tim Wan eas Dees GS eb ls mad sass nla“ ead “cesses ‘case eal meme “os eh Sw as Teas Sk vee od onl wes ln tes tab Gd ew ence se ce aes 
ies Call : PRUM xe 


SHAK KKKKKEKAEKKKEKK KEE KKK AKER KAKA IKK KEKE EK KEK KEKE KKKKAKKEKKEKKKKK 
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code segment para '‘CODE' 7Definition of the CODE segment 
org 100h 


assume cs:code, ds:code, es:code, ss:code 


start: jmp prumini sthe first executable command 
alterint equ this dword 7Old interrupt vector 17 (h) 

intaltofs dw (?) :Offset address Interrupt vector 17h) 
intaltseg dw (7) ;Segment address Interrupt vector 17 (h) 


7-~- The following table contains the new --~--------- 
j-- code followed by the old code ------------------- 


codetab db 64, 21 2 Q  -+------- > '@! 
db 125,129 pf! ---------- >}! 
db 123,132 : ta! ---------- > "4? 
db 91,142 3 ‘At ---------- > '[' 
db 124,148 g 9G! Hanae > 
db 92,153 3 'O! ---------- > \8 
db 93,154 3 'Ut ---------- >)! 
db 126,225 3 'R' ---------- > tat 
db 0 ;End of the table 


7== this is the new printer interrupt (remains in memory) =========== 
newpri proc far 


jmp short newpri 1 


db "Cw" zIdentification of the program 
newpri 1: or ah,ah 7print character (function 0)? 
jne aint 7;NO --> ;address of the code table 
mov bl,al 7store code in BL 
testcode: lodsw z;load old (AH) and new code (AL) 
or al,al ;Reached end of table ? 
je not found 7YES --> Code not found 
cmp ah,bl zIs it the code for conversion 
jne testcode 7;NO --> continue to search table 
jmp short nreset zit was a code for conversion 


notfound: mov al,bl 
nreset: xor ah,ah 


;move old code to AL again 
;set function number 0 again 


pop ds ;restore registers 

pop si 

pop bx 

popf 
aint: jmp cs: [alterint] 7to old printer routine 
newpri endp 


instend equ this byte 


jup to this mem location everything must 


;remain resident 


r== Data (can be overwritten by DOS) =======s==s===s====s==s==s=s=== 


installm db 13,10,"PRUM (c) 1987 by Michael Tischer",13,10,13,10 
db “PRUM was installed and can be deactivated with ",13,10 
db “a new call",13,10,"$" 


removeit db "PRUM was deactivated$",13,10 


z~-~ Start and Initialization Routine 


7. The BIOS PC System Programming 


prumini label near 


mov ax,3517h zget content of interrupt vector 17 (h) 
int 21h ;call DOS function 

cmp word ptr es: [bx+2],"WC" ;test if PRUM program 

jne install s;SHOWCL not installed --> INSTALL 


z7-~ PRUM was deactivated ~-------- enn nnn nr 


mov dx,es:intaltofs ;Offset address of interrupt 17 (h) 


mov ax,es:intaltseg 7Segment address of interrupt 17 (h) 
mov ds,ax ;to DS 

mov ax,2517h ;deflect content of the interrupt 
int 21h rvector 17(h) to old routine 

mov ah,49h ;release storage of old PRUM 

int 21h yagain 

push cs 7;store CS on stack 

pop ds j;restore DS 


mov dx,offset removeit ;Message: Program removed 


mov ah,9 ywrite function number for atring 
int 21h ;call DOS function 
mov ax, 4C0O0h ;terminate program 
int 21h 7Ccall function program termination 


y-- install PRUM ----------<- 322 rn 


install label near 


mov ax,3517h 7get content of interrupt vector 17 
int 21h ;call DOS function 

mov intaltseg,es 7Save segment- and offset address 
mov intaltofs,bx ; of the interrupt vector 17 (h) 


mov dx,offset newpri ;Offset address new interrupt routine 
mov ax,2517h ;deflect content of interrupt 
int 2ih 7 vector 17 to user routine 


mov dx,offset installm ;Message: Program installed 
mov ah,9 youtput function number for string 
int 21h 7;call DOS function 


77- only the PSP, the new interrupt routine and the --------- 
;-~ data pertaining to it must remain resident. ---------- 


mov dx,offset instend ;calculate the number of 


mov cl,4 7paragraphs (each 16 bytes) available 
shr dx,cl 7; to the program 
inc dx 
mov ax,3100h 7end program with end code O (o.k) 
int 21h ;but remain resident 

code ends 7End of the CODE segment 


end start 
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7.13 Reading the Date and Time from the BIOS 


The various time functions of the ROM-BIOS can be addressed through BIOS 
interrupt 1AH. The PC and XT each have two time/date functions. The AT has 
eight time/date functions available to the user. 


Realtime clock 


The enhanced functions included in the AT operate in conjunction with the AT's 
battery powered realtime clock (RTC). The realtime clock continues keeping time 
even when the AT is switched off. This clock's method of timekeeping is quite 
different from PC and XT time. PC and XT models measure time using timer 
interrupt 8H, which the system calls about 18.2 times per second. Timer interrupt 
8H remains independent of the CPU's clock frequency. The AT ROM-BIOS 
maintains control of this interrupt, but only for maintaining software 
compatibility with the PC and XT. The AT BIOS receives the current time from 
the realtime clock accessing the CPU. 


Function OOH: Get clock 


Function number OOH gets the current clock time. You can call this function by 
passing the number (0) to the AH register. The function loads the time into the 
CX and DX registers. These two registers combine to form a 32-bit counter value 
(CX contains the most significant 16 bits, while DX contains the least significant 
16 bits). The BIOS timer increments this value by 1 each time interrupt 8H is 
called (18.2 times per second). The total value is the result of multiplying the 
contents of CX register by 65,536 and adding the contents of the DX register. 
Dividing this value by 18.2 returns the number of seconds elapsed, which can then 
be converted into minutes and hours. 


The AT interprets time differently from the PC and XT. The PC/XT BIOS sets 
this counter to 0 during the system booting process. The value returned is the time 
passed since the computer was switched on (not the actual time). To obtain the 
time, the current time must be converted to the value corresponding to the counter, 
then passed to the BIOS (more on this later). The AT doesn't require this time 
value conversion since BIOS reads the actual time from the realtime clock during 
the system boot. It converts this time into a suitable timer value and saves it. 
Reading the counter with the help of function 0 on the AT thus provides the 
current time. 


Besides this counter, a value the AL register indicates whether or not 24 hours 
have passed since the last reading. If the AL register contains a value other than 0, 
24 hours have passed. This value does not indicate how many 24-hour periods have 
elapsed since the last reading. 


If the conversion of time values into clock time is too complicated, function 2CH 
of DOS interrupt 21H can be used. This function simply reads and converts the 
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current time using function 0 of interrupt 1AH (see Chapter 18 of this book for 
more information about function 2CH of DOS interrupt 1AH). 


Function 01H: Set clock 


Function number 01H sets the current clock time. You can call this function by 
loading the number 1 into the AH register, the most significant 16 bits of the 
counter into the CX register and the least significant 16 bits into the DX register. 
These two registers combine to form a 32-bit time value. If the conversion of the 
Current time into a timer value is too complicated, function 2DH of DOS interrupt 
21H can be used instead (see Chapter 18 of this book for more information about 
function 2DH of DOS interrupt 21H). 


The next six functions are available only on the AT. If you attempt to call these 
functions on a PC or an XT, nothing will happen (use the model identification 
program described in Section 7.3 to check for AT hardware). 


All six functions use BCD format for time and date indications. In this format, 
two characters are coded per byte, where the higher number is coded in the higher 
nibble and the lower number in the lower nibble. All six functions use the carry 
flag following a return from the function call. If the carry flag is set, this indicates 
that the realtime clock is malfunctioning (e.g., dead battery). The called function 
could not be executed properly. 


Function 02H: Get current time 


Function 02H reads the realtime clock time. You can call the function by loading 
the function number (2) into the AH register. The current time is returned with the 
hour in the CH register, minutes in the CL register and the seconds in the DH 
register. 


Function 03H: Set current time 


Function 03H sets the time on the realtime clock. You can call the function by 
loading the function number (3) into the AH register, the hour into the CH 
register, minutes into the CL register and seconds into the DH register. The DL 
register indicates whether the "daylight savings time" option is desired. A 1 in the 
DL register selects daylight savings time, while 0 maintains standard time. 


Function 04H: Get current date 
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Functions 4 and 5 read and set the date stored in the realtime clock. Both functions 
use the century, the year, the month and the day as arguments. The day of the week 
(also administered by the realtime clock) does not apply to these functions. If you 
want to read the day of the week, direct access must be made to the realtime clock 
(see Chapter 10 for instructions on direct access). 
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Function 04H gets the current date from the realtime clock. You can call this 
function by loading the function number (4) into the AH register. The CH register 
contains the first two numbers of the year (the century). The CL register contains 
the last two numbers of the year (e.g., 88). The month is returned in the DH 
register, and the day of the month in the DL register. 


Function 05H: Set current date 


Function OSH sets the current date in the realtime clock. You can call this function 
by loading the function number (5) into the AH register, either 19 or 20 into the 
CH register, the last two numbers of the year into the CL register (e.g., 89 
decimal), the month into the DH register, and the day of the month into the DL 
register. 


Function 06H: Set alarm time 


Function 06H allows the user to set an alarm. Since only the hour, minute and 
second can be indicated, the alarm time applies only to the current day. When the 
clock reaches the alarm time, the realtime clock calls a BIOS routine which in turn 
calls interrupt 4AH. A user routine can be installed under this interrupt to simulate 
the sound of an alarm clock (you can program the routine to make other sounds). 
During the system initialization interrupt 4AH moves to a routine which contains 
only the IRET assembly language instruction. The IRET instruction forces the 
CPU to terminate the interrupt so that arriving at alarm time doesn't result in any 
action visible to the user. You can call this function by loading the function 
number (6) into the AH register, the alarm hour into the CH register, the alarm 
minute into the CL register and the alarm second into the DH register. 


Function 07H: Reset alarm time 


Only one alarm time can be set. If this function is called while another alarm time 
is set, or has not yet been reached, the carry flag is set after the function call. A 
new alarm time doesn't replace the old alarm time; the old time must be deleted 
first. You can call this function by loading the function number (7) into the AH 
register; no other parameters are required. This call clears the last alarm time so 
that a new alarm time can be programmed. 
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7.14 BIOS Variables 


The preceding sections described different BIOS interrupts and their functions. 
These functions require a segment of memory for storing variables and data. For 
this reason, the BIOS reserves the area of memory between addresses 0040:000 and 
0050:0000 for storing internal variables. The contents of most of these variables 
can be read using some BIOS functions, or by using direct access. Sometimes 
direct access is the easiest method of the two, but it increases the odds of a 
program not executing properly on certain PCs. Since the BIOS can vary from PC 
to PC, different BIOS versions may use individual memory locations within this 
area in different ways. When working with "standard issue" PCs and compatibles 
(e.g., IBM, Tandon, etc.), you can assume that the memory assignment provided 
here remains constant between machines. 


The following list describes the individual variables, their purposes and addresses. 
The address indicated is the offset address of segment address 0040H. For example, 
a variable with the offset address 10H has the address 0040:0010 or 10H. 


0OH—07H 


During the booting process, a BIOS routine determines the configuration of its 
PC. It determines, among other things, the number of installed serial (RS-232) 
interfaces. These interface numbers are stored as four words in memory locations 
0040:0000 to 0040:0007. Each one of these words represents one of the four cards 
that can be installed for asynchronous data transmission. First the low byte is 
stored, followed by the high byte. Since few PCs have four serial cards at their 
disposal, the words which represent a missing card contain the value 0. 


O8H—OFH 


During the booting process, a BIOS routine determines the configuration of its 
PC. It determines, among other things, the number of installed parallel interfaces. 
These card numbers are stored as four words in memory locations 0040:0008 to 
0040:000F. Each one of these words stands for one of the four cards that can be 
installed for parallel data transmission. First the low byte is stored, followed by 
the high byte. Since few PCs have four parallel cards at their disposal, the words 
which represent a missing card contain the value 0. 


10H—11H 
This word represents the hardware configuration of the PC as called through BIOS 
interrupt 11H. Similar to the above two words, this configuration is determined 


during the booting process. The purposes of individual bits of this word are 
standardized for the PC and the XT, but can differ in some other computers. 
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12H 


This byte provides storage for information gathered during the system self-test, 
executed during the booting process and after a warm start. BIOS routines also use 
this byte for recognizing active keys. It has no practical use for the programmer. 


13H—14H 


This word indicates the RAM capacity of the system in kilobytes. This 
information is also gathered during the booting process, and can be read using 
BIOS interrupt 12H. 


15H—16H 


These two bytes test the hardware during the booting process. They have no further 
use after each hardware test. 


17H 


This is called the keyboard status byte because it contains the status of the 
keyboard and different keys. Function 02H of BIOS keyboard interrupt 16H reads 
this byte. Accessing this byte allows the user to toggle the <Insert> or <Caps 
Lock> key on or off. The upper four bits of this byte may be changed by the user; 
the lower four bits must remain undisturbed. 


1=Left SHIFT key pressed 
1=CTRL key pressed 
1=ALT key pressed 


1=SCROLL LOCK on 


1=NUM LOCK on | 


1=CAPS LOCK on_ 


1=INSERT on . 


Keyboard status byte 


18H 


This byte is similar to byte 17H above, with the difference that this byte indicates 
the active status of the <SysReq> and <Break> keys. 


Cod 
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Tt} ty tt 


(AT & some XT) 
| 


Extended keyboard status byte 


19H 


This byte currently serves no purpose; it will be used for status in a proposed 
extended keyboard once that keyboard appears on the market. 


1AH-1BH 


This word contains the address of the next character to be read in the keyboard 
buffer (see also LIEH—3DH below). 


1CH—1DH 


This word contains the address of the last character in the keyboard buffer (see also 
1EH—3DH below). 


1EH—3DH 


This area of memory contains the actual keyboard buffer. Since every character 
stored in the keyboard buffer requires 2 bytes, its 32-byte capacity offers space for a 
maximum of 16 characters. For a normal ASCII character, the buffer stores the 
ASCII code and then the character's scan code. The scan code is the number of the 
activated key which generated the ASCII character. If the character in the keyboard 
buffer uses an extended code (e.g., a cursor key), then the first byte contains the 
value 0 and the second byte contains the extended key code. 


The computer constantly reads characters from the keyboard buffer. If the buffer is 
not full, characters can be added. The address of the next character to be read from 
the keyboard buffer is stored in the word at memory location 0040:001AH. When a 
Character is read, the character moves by 2 bytes toward the end of the buffer in 
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memory. When a character was read from the last memory location of the buffer, 
this pointer resets to the beginning of the buffer. 


The same is true of the pointer in memory location 0040:001C, which indicates 
the end of the keyboard buffer. If you add a new character, it is stored in the 
keyboard buffer at the location indicated by this pointer. Then the pointer is 
incremented by 2 to move toward the end of the buffer. If a new character is stored 
at the last memory location of the buffer, this pointer resets to the beginning of 
the buffer. 


The relationship between the start and end pointers tells something about the 
buffer's status. Two conditions are of special interest. The first is the condition 
when both pointers contain the same address (no characters are currently available 
in the keyboard buffer). The other condition is when a character should be appended 
to the end of the keyboard buffer, but adding 2 to the end pointer would point it to 
the start pointer. This means that the keyboard buffer is full, i.e., no additional 
characters can be accepted. 


0040:003D 


0040:001A 


Pointer to 
next character 
in 0040:001A 


0O040:001E 0040:0024 


Pointer to 


0040:002A 


0040:002B 
Two byte 


character 


Normal character: ASCII code 


last character 
in 0040:001C 


Extended character: OOH 


Keyboard buffer with start and end pointers 
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3EH 


The lowest four bits correspond to the number of installed PC disk drives (you are 
allowed a maximum of four drives). These bytes also indicate whether the 
connected drives must be calibrated. This is mostly the case after an error occurs 
during read, write or search access. When an error occurs, the corresponding bit in 
this byte is set to 0. 


3FH 
The four lower bits of this byte indicate whether the current disk drive motor is in 


motion. A 1 in the corresponding bit indicates this. In addition, bit 7 is always set 
when write access is in progress. 


40H 


This byte contains a numerical value which indicates the time period until a disk 
drive motor switches off. Since BIOS can only access one disk drive at a time, this 
value refers to the drive last accessed. Following access to this drive, BIOS places 
the value 37 into this register. During every timer interrupt (which occurs about 
18.2 times per second), the value in this byte is decremented by 1. When it finally 
reaches 0, the disk motor is turned off. This takes place after about two seconds. 


41H 
This byte contains the status of the last disk access. When the byte contains the 


value 0, the last disk operation was performed in an orderly manner. Another value 
signals that an error code was transmitted by the disk controller. 


42H—48H 


These seven bytes indicate the status of the NEC disk controller. They also 
indicate hard disk controller status on hard disk systems. 


49H 
This byte contains the current display mode as reported by the BIOS. This is the 
same value indicated when the user activates a display mode through function 0 of 
the BIOS video interrupt 10H. 


4AH 


This word contains the number of text columns per display line in the current 
display mode. 
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This word contains the number of bytes required for the display of a screen page in 
the current display mode, as reported by the BIOS. In the 80x25-character text 
mode, this is 4,000 bytes. 


4FH 


This word contains the address of the current screen page now on the monitor, 
relative to the beginning of video card RAM. The video RAM of the color card 
starts at B800:0000 for the first screen page, and at B800:1000 for the second 
screen page in 80x25-character text mode. This variable usually contains the value 
1000H. 


5SFH 


These 16 bytes contain the current cursor position for each screen page. BIOS can 
control a maximum of 8 screen pages. BIOS reserves two bytes for each screen 
page. The low byte indicates the screen column, which can have values ranging 
from 0 to 39 (in 40-column mode) or from 0 to 79 (Gin 80-column mode). The high 
byte indicates the screen line, which can have values ranging from 0 to 24. If you 
change the values in this table, the immediate position of the blinking cursor 
remains unchanged, but the change will become noticeable the next time you enter 
characters into the corresponding display page. 


You can use these bytes for positioning the cursor, but we don't recommend this 
method. 


This byte contains the starting line of the blinking cursor, which can have values 
ranging from 0 to 7 (color graphic card) or from 0 to 14 (monochrome graphic 
card). Changing the contents of this byte doesn't change the cursor's appearance, 
since it must first be transmitted by BIOS to the video controller. 


This byte contains the ending line of the blinking cursor, which can have values 
ranging from 0 to 7 (color graphic card) or from 0 to 14 (monochrome graphic 
card). Changing the contents of this byte doesn't change the cursor's appearance, 
since it must first be transmitted by BIOS to the video controller. 


This byte contains the number of the currently displayed screen page. 
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63H—64H 


65H 


66H 


67H— 


6CH— 


70H 


71H 


404 


This word contains the video card port. If a PC contains several video cards, the 
value stored will be the address of the currently active video card. 


The contents of a video controller card's mode selector dictates the current display 
mode. The current value is stored in this memory location. 


A color card in medium-resolution graphic mode can display 320x200 pixels in 
four different colors. Three of these colors originate from one of the two color 
palettes. This byte contains the currently active color palette (either O or 1). 


6BH 


The early PC BIOS versions could use a cassette recorder for data storage. Those 
early versions of BIOS used these five bytes for cassette access when storing data. 
XT and AT models, which do not have this interface, use these memory locations 
in connection with RAM expansion. 


6FH 


These four bytes act as a 32-bit counter for both BIOS and DOS. The counter is 
incremented by 1 on each of the 18.2 timer interrupts per second. This permits 
time measurement and time display. The value of this counter can be read and set 
with BIOS interrupt 1AH. If 24 hours have elapsed, it resets to 0 and counts up 
from there. | 


This byte contains a 0 when the timer routine is between 0 and 24 hours. Byte 
70H changes to 1 when the time counter routine exceeds its 24-hour limit. For 
every subsequent 24-hour count, this byte remains at 1. 


If the BIOS timer interrupt 1AH is used to set the time, this byte resets to 0. 


This byte indicates whether or not a keyboard interrupt occurs after the user presses 
<Ctrl><C> or <Ctrl><Break>. If bit 7 of this byte contains the value 1, a 
keyboard interrupt has occurred. 
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72H—73H 


During the booting process, a reset command is sent to the keyboard Controller. 
For the duration of this reset, the word at this location assumes the value 1234H. 


XT BIOS variables 


The hardware configurations of the XT permit the introduction of additional 
variables. The following is a list of BIOS variables found in the XT and AT. 


74H—77H 


These four bytes are used only by hard disk systems for hard disk control. 


78H—7BH 


Each of these four bytes returns the status of one of the four printer ports. 


7CH—7FH 


Each of these four bytes returns the status of one of the four asynchronous 
communication (RS-232) ports. 


80H—81H 
This word contains the beginning of the keyboard buffer as the offset address to the 


segment address 0040. Since the keyboard buffer normally starts at address 
0040:001E, this memory location usually contains the value 1EH. 


82H—83H 
This word contains the end of the keyboard buffer as the offset address to the 


segment address 0040. Since the keyboard buffer normally ends at address 
0040:003E, this memory location usually contains the value 3EH. 


AT BIOS variables 


The advanced features of the AT require even more BIOS variables. Here is a list of 
the BIOS variables found only on AT models. 


88H 


This byte contains the last data transmission speed of the disk drive or hard disk. 
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8CH—96H 


This memory range contains variables necessary during disk/hard disk access. 


97H 
This byte reserves a keyboard flag which shows the status of the AT keyboard's 
LED (light-emitting diode). 

98H—AOH 


This memory range accepts variables from the battery-powered realtime clock. 


All members of the PC family (PC, XT and AT) have a variable in memory 
location 0050:0000. This variable works in conjunction with the hardcopy routine 
(interrupt 5) to prevent printer output during the printing of another hardcopy. The 
‘hardcopy routine tests for whether this flag has a value of 0. If so, and no hardcopy 
is being printed, the flag changes to 1. The BIOS can check this variable to see 
whether a printout is in process. After a successful printout, this flag resets to 0 to 
allow additional printing. If an error was detected during printer access, this flag is 
set to the value 255 and the printing procedure aborts. 
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Chapter 8 


Terminate and Stay Resident 
Programs 


Since its birth, DOS has been criticized for its inability to handle multitasking 
(running more than one program at a time). Even though OS/2 is capable of 
multitasking, it runs only on ATs or 80386-based computers. But TSR (Terminate 
and Stay Resident) programs can bring some of the advantages of multitasking 
into the world of DOS machines. This type of program moves into the 
"background" once it is started, and becomes active when the user presses a 
particular key combination. The SideKick® program produced by Borland 
Intemational made TSR programs very popular. 


Running a TSR program isn't multitasking in the true sense of the word, since 
only one program is actually running at any given time. However, with the touch 
of a key, the user can immediately access such useful tools as a calculator, 
calendar, or note pad. In addition to these applications, macro generators, screen 
layout utilities and text editors can also be found in TSR form. 


Many TSR programs can even interact with the programs that they interrupt, and 
transfer data between the TSR and the interrupted program. One example of this 
would be a TSR appointment book that inserts a page from its calendar in a file 
loaded into a currently running word processor. 


Although many different applications can be implemented with TSR programs, 
TSR programs have two things in common: 


° all use the same basic method of operation 
° all are built on similar programming concepts 


This chapter examines these two items, and demonstrates simple implementations 
of TSR programs. 
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Before we begin, we should point out that this involves very complex 

programming. Comprehending this material requires a certain level of 
understanding about how things work within the system. This is especially true of 
TSR programs, since by their very definition they all but ignore the single-task 

nature of DOS, in which one program has access to all of the system resources 

(RAM, screen, disk, etc.). A TSR program must contend with many other 

elements of the system such as the BIOS, DOS, the interrupted program, and even 

other TSR programs. Managing this is a difficult but rewarding task, and can only 

be realized in assembly language. Of the available PC languages, only assembly 

language offers the ability to work at the lowest system level, the interrupt level. 

But although it has this capability, assembly language is as flexible as high level 

languages for writing TSR applications such as calculators or note pads. Because 

of this we'll list two assembly language programs in this chapter which will allow 

you to "convert" Turbo Pascal, Turbo C, and Microsoft C programs into TSR 

programs. 


Activating TSR programs 
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Let's start by looking at how a TSR program is activated. To make our TSR 
program come to the foreground immediately after we press a certain key 
combination (called the hotkey), we must install some sort of activiation 
mechanism tied to the keyboard. We can use interrupts 09H and 16H, two system 
keyboard calls. Interrupt 16H is the BIOS keyboard interrupt, which programs use 
to read characters and keyboard status. If we use this interrupt, then our TSR 
program can only be activated when the main program is using interrupt 16H for 
keyboard input. 


It would be better to use interrupt 09H, which is called by the processor whenever 
a key is pressed or released. We can redirect this interrupt to our own routine, 
which can check to see if the TSR program should be activated or not. Before it 
does this, the routine should call the old interrupt 09H handler. There are two 
reasons for this. The first has to do with the task of interrupt 09H, which informs 
the system that the keyboard needs the system's attention in order to transfer 
information about a key event. Therefore, interrupt 09H normally points to a 
routine within the ROM BIOS which accepts and evaluates information from the 
keyboard. Specifically, it receives the code from the keyboard, converts it to an 
ASCII code, and then places this code in the BIOS's keyboard buffer. Since our 
TSR program neither wants nor is able to handle this job, we must call the 
original routine, or keyboard input will be impossible. 


The second reason has to do with the fact that it is possible that other TSR 
programs were installed before ours, which have redirected interrupt 09H to their 
own routines. Since our program is in front of these programs in the interrupt 
handler chain, their interrupt routines will not be called automatically if we do not 
call the old interrupt handler. The result would be that we could no longer activate 
these TSR programs. The end result is that when a TSR program is called via a 
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redirected interrupt routine, it should always call the old interrupt handler before or 
after its own interrupt processing. 


The call must not be made with the INT assembly language instruction, since this 
would just recall our own interrupt handler. This would lead to an infinite loop in 
most cases, a stack overflow and an eventual system crash. To avoid this we must 
save the address of the old interrupt handler when the TSR program is installed. 
We can then call the old interrupt handler with this stored address with the help of 
a FAR CALL instruction. To simulate calling this handler through the INT 
instruction, we must first place the contents of the flag register on the stack with 
the PUSHF instruction before the CALL. 


return to program 
Keypress 


Call old handler Sutdvateu@is eee Hotkey? 


YES 
Call old handler activate q... Hotkey? 


ee 6 
YES 
Call old handler activate qLWWHWH Hotkey? 


Read character 
from keyboard and 
convert to ASCII 
code 


Last installed 
TSR program 


Other installed 
TSR program 


First installed 
TSR program 


Original 


Reading keys for TSR programs using interrupt 09H 


handler for interrupt 
09(h) in ROM-BIOS 


After the return from the interrupt handler, we can check to see if the hotkey was 
pressed to activate the TSR. The BIOS keyboard flag at address 17H in the BIOS 
variable segment (segment address 0040H) indicates the status of the following 
keys: 


right <Shift> key 
left <Shift key 
<Ctrl> key 
<Alt> key 
<Num> key 


<Scroll Lock> key 
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DOS 


e <CapsLock> key 
. <SysReq> key (AT keyboard only) 


If the appropriate keys are pressed, the user is trying to activate the TSR program. 
We can only do this if certain conditions are met, all of which come down to the 
fact that the DOS is not re-entrant. 


Since the TSR program can be activated from the keyboard at any time, regardless 
of the other processes in the system, it could conceivably interrupt a call to a DOS 
function. This may not lead to problems as long as the TSR program returns to 
the interrupted DOS function properly. The problem occurs when the TSR itself 
tries to call DOS functions, which is hard to avoid when programming in a high 
level language. Here we see the problem of re-entry. This refers to the ability of a 
system to allow multiple programs to call and execute its code at the same time. 
DOS is not re-entrant, however, since it is a single-task system and assumes that 
DOS functions will be called in sequence, and not in parallel. 


Calling a DOS function from within a TSR program while another function is 
executing leads to problems because the processor register SS:SP is loaded with 
the address of one of three DOS stacks when interrupt 21H is called. Which of the 
three stacks is used depends on the function group to which the DOS function 
belongs, and cannot be determined by the caller. While the DOS function is being 
executed, it places temporary data on this stack as well as the return address to the 
calling program. If the execution of the function is then interrupted by the 
activation of a TSR program which then calls a DOS function, DOS will again 
load register pair SS:SP with the starting address of an internal stack. If it is the 
same stack that the interrupt function was using, each access to the stack will 
destroy the data of the other function call. The DOS function called by the TSR 
program will be executed properly, but the problem will occur when the TSR 
program ends and control returns to the interrupted DOS function. Since the 
contents of the stack have been changed in the meantime by other DOS calls, the 
DOS function will probably crash the system. 


Bypassing re-entry 
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There are two ways to get around these re-entry problems: Avoid calling DOS 
functions, or allow the TSR program to be activated only if no DOS functions are 
being executed. We have already ruled out the first option, so we must use the 
second. DOS helps us here by providing the INDOS flag, which is normally only 
used inside DOS but which is very useful to us as well. It is a counter which 
counts the nesting depth of DOS calls. If it contains the value 0, no DOS 
functions are currently being executed. The value 1 indicates the current execution 
of a DOS function. Under certain conditions this counter can also contain larger 
values, such as when one DOS function calls another DOS function, which is 
allowed only in special cases. 
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Since there is no DOS function to read the value of this flag, we have to read the 
contents directly from memory. The address does not change after the system is 
booted, so we can get the address when the TSR is installed and save it in a 
variable. DOS function 34H returns the address of the INDOS flag in register pair 
ES:BX. 


This flag is read in the interrupt handler for interrupt 09H since it checks to see if 
the hotkey was pressed, and allows the TSR program to be activated only if the 
INDOS flag contains the value 0. This is not the whole solution to the problem, 
however. It coordinates the activation of the TSR program with DOS function 
calls of the transient program being executed in the foreground, but it does not 
allow the TSR program to be called from the DOS user interface. Since the DOS 
command processor (COMMAND.COM) uses some DOS functions for printing 
the prompt and accepting input from the user, the INDOS flag always contains the 
value 1. In this special case we can interrupt the executing DOS function, but we 

_ must make sure that the INDOS flag contains the value 1, because a DOS function 
can be called from transient program or from the DOS command processor. 


There is a solution for this problem too. It involves the fact that the DOS is in a 
kind of a wait state when it is waiting for input from the user in the command 
processor. To avoid wasting any valuable processor time, it periodically calls 
interrupt 28H, which is responsible for short term activation of background 
processes like the print spooler (DOS PRINT command) and other tasks. If this 
interrupt is called, it is relatively safe to interrupt DOS and call the TSR program. 


To use this procedure, a new handler for interrupt 28H is installed when the TSR 
program is installed. It first calls the old handler for this interrupt and then checks 
to see if the hotkey has been pressed. If this has occurred, the TSR program can be 
activated, even if the INDOS flag is not 0. 


One more restriction must still be added—we cannot allow the TSR program to be 
activated, even using the handler for interrupt 09H, if time-critical actions are 
being performed in the system. 


Time-critical actions 


These are actions which, for various reasons, cannot be interrupted because they 
must complete execution in a relatively short time. In the PC this includes 
accesses to the floppy and hard disk, which at the lowest levels are controlled by 
BIOS interrupt 13H. If an access to these devices is not completed by a certain 
time it can cause serious system disruptions. A dramatic example is if the TSR 
program performs an access to these devices before another access, which is 
initiated by the interrupted program, has finished. Even if this doesn't crash the 
system, it will lead to loss of data. 


We can avoid this by installing a new interrupt handler for BIOS interrupt 13H. 
When this handler is called, it sets an internal flag which shows that the BIOS disk 
interrupt is currently active. Then it calls the old interrupt handler which performs 


411 


8. Terminate and Stay Resident Programs PC System Programming 


the access to the floppy or hard disk. When it returns to the TSR handler, the flag 
is cleared, signalling the end of BIOS disk activity. 


To prevent this interrupt handler from being interrupted, the other TSR interrupt 
handlers all monitor this flag and will activate the TSR program only if the flag 
indicates that the BIOS disk interrupt is not active. 


Recursion 


One last condition placed on the activation of a TSR program is that recursive 
activations are prohibited. Since the hotkey can still be pressed after the TSR 
program has been activated, we must prevent the TSR program from being 
reactivated before it is finished. We can simply add another flag which is checked 
before the TSR is activated. The TSR program sets this flag when it begins and 
clears it again just before it ends. If an interrupt handler determines that this flag is 
set, it will simply ignore the hotkey. | 


Once all of these conditions have been satisfied, we can activate the TSR program. 


Context. switch 
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The process of activating a TSR program is called a context switch. The program 
context or environment is all the information needed for operating the program. 
This includes such things as the contents of the processor registers, important 
operating system information, and the memory occupied by the program. We don't 
have to worry about the program memory in our context switch, however, since 
our TSR program is already marked as resident, meaning that the operating system 
will not give the memory it occupies to other programs. 


The processor registers, especially the segment registers, must be loaded with the 
values which the TSR program expects. These are saved in internal variables when 
the TSR program is installed. Since the contents of these and other registers will 
be changed by the TSR program, the contents of the registers must be saved 
because they belong to the context of the interrupted program and must be restored 
when it is resumed. 


The same applies for context dependent operating system information, which for 
DOS includes just the PSP (Program Segment Prefix) of the program and the 
DTA (Disk Transfer Area). The addresses of both structures must be determined and 
saved when the TSR program is installed, so that they can be reset when context is 
changed to the TSR program. Also, we must not forget to save the addresses of the 
PSP and DTA of the interrupted program before the context change to the TSR 
program. There are DOS functions for setting and reading the address of the DTA 
(DOS functions 1AH and 2FH), but there are no corresponding documented 
functions for the PSP. DOS Version 3.0 includes function 62H, which returns the 
address of the current PSP, but has no function for setting the address. 
Undocumented functions for doing both exist in DOS 2.0: function 50H (set PSP 
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address) and 51H (get PSP address). Both of these are used in our TSR 
demonstration program. 


One final task is required of the TSR code. When the TSR program is activated 
using interrupt 28H, an active DOS function is interrupted—one whose stack must 
not be disturbed. Generally we should take the top 64 words from the current stack 
and place them on the stack of the TSR program. This completes the context 
change to the TSR program, which means that the TSR program can now be 
Started. 


At the moment, the TSR program can be viewed as a completely normal program 
which can call arbitrary DOS and BIOS functions. The only competitor left in the 
system is the foreground program. The TSR must ensure that it leaves both the 
foreground program and its screen undisturbed. 


the screen context 


The tasks were exclusively handled in assembly language. However, the C or 
Pascal program comprising the TSR program itself can save the screen context. 
This screen context includes the current video mode, the cursor position and the 
screen's contents. The contents of the color registers and other registers on the 
video card must also be saved, if any of these values are changed by the TSR 
program. 


As described in Section 7.4, the video mode can easily be determined with function 
OOH of BIOS video interrupt 16H. If the screen is in text mode (modes 0, 1, 2, 3, 
and 7), the TSR program must save the first 4000 bytes of video RAM. The video 
BIOS can be used for this (see Section 7.4), or you can access the video RAM 
directly (see Chapter 10). 


Saving the video mode becomes very complicated if a graphics mode is active, 
since the video RAM for EGA and VGA cards can be as large as 256K in some 
modes. If the TSR program interrupted a transient program, it may not be possible 
to allocate a large enough buffer to handle both programs. 


This is why many TSR programs will not activate themselves from within 
graphics mode, and can only be used in text mode. Since PCs mostly use text 
mode, this doesn't present a big problem. GEM® and Microsoft Windows®, 
which operate only in graphics mode, are exceptions. Since these programs usually 
support some mechanism for parallel execution of calculators, note pads, etc., 
TSR programs can prove less useful under these systems. 


The assembler interface 


We now have enough information to understand the operation of the two assembly 
language interfaces. The two programs are based on the principles we have outlined 
here; the differences between them reflect the different syntaxes of compiled C and 
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Pascal programs. We will first concentrate on the common points of the two 
programs. 


Both programs assume that the TSR program was installed by the first call from 
the DOS level, and will be reinstalled on each new call. It is important to 
remember one general rule: a TSR program can be reinstalled only if no other TSR 
programs have been installed in the meantime. The LIFO (Last In, First Out) 
principle applies here, so the only way a TSR program can be reinstalled is if it 
was the last one to be installed, and if the corresponding interrupt vectors point to 
its interrupt handlers. If another TSR program was installed following it, the 
interrupt vectors point to its handlers. 


To support this mechanism, the assembly language interface offers the high-level 
program three routines with which install and later reinstall the TSR program. To 
decide whether the program should be installed or reinstalled, the first function 
should be called to see if the TSR program is already installed. This routine is 
passed an identification string, which will play an important role later when the 
program is installed. The routine looks for this ID string within the handler for 
interrupt O9H. If it finds the string, the TSR program is already installed and can 
be reinstalled. 


If the ID string is not discovered, the TSR program has not been installed, or 
another TSR program redirected the interrupt 09H vector in the meantime. The 
TSR program can then be installed with the help of the installation routine. This 
routine must receive the ID string used to detect whether the program has already 
been installed, the address of the high level routine which will be called when the 
TSR program is activated, and the hotkey value. The hotkey value is the bit 
pattern in the BIOS keyboard flag which will activate the TSR program and can be 
defined within the high level language program with the help of predefined 
constants. 


The initialization routine first saves the addresses of the interrupt handlers for 
interrupts 09H, 13H and 28H. Then the data for the context of the high level 
program are read and saved in variables within the code segment, so that they are 
available for the interrupt handler and for activation of the TSR program. In the 
next step, the new interrupt handlers for interrupts 09H, 13H, and 28H are 
installed. Finally, the number of paragraphs after the end of the program which are 
to remain resident must be calculated. Here the C and Pascal interfaces differ from 
each other. Information about this calculation can be found in the individual 
descriptions of the interfaces. 


The actual installation is now over and the program is terminated as resident. 
Notice that the installation routine does not return to the high level language 
program, so all initialization such as memory allocation or variable initialization 
must be performed before the call to this routine. 


Abacus 


8. Terminate and Stay Resident Programs 


If the test function of the assembly language module determines that the program 
is already installed, it can be reinstalled with the help of another function. This 
function is passed the address of a routine in the high level language program 
which will perform a "cleanup" of the program. This process includes releasing 
allocated memory and other tasks. If no such routine is to be called, the assembly 
language routine must be passed the value -1. Since the "cleanup" function is in 
the TSR program, and not in the program which is performing the reinstallation, a 
context switch is necessary. Unlike activation of the TSR program and the 
corresponding interruption of the foreground program, this is from the program 
which 1s doing the reinstallation to the already installed TSR program. The 
reinstallation returns the redirected interrupt handlers to their old routines and 
releases the memory allocated by the TSR program. 


In addition to these three functions which are called from the high level language 
program, the assembler module contains some routines which may not be called 
by high level language programs. These include the interrupt handlers for 
interrupts 09H, 13H, and 28H as well as a routine which accomplishes the context 
switch to and from the TSR program. 


The high level language programs 


The following programs in C and Pascal demonstrate the assembly language 
routines. They first check to see if the program is already installed or not. On a 
new installation, a TSR routine is installed. You can activate the TSR by pressing 
both <Shift> keys. It stores the screen contents, then displays a message and asks 
the user to press a key. After this is done, the old screen contents are copied back 
and the execution of the interrupted program continues. 


On a reinstallation, the assembly language reinstallation program calls a cleanup 
function in the TSR program. It prints the number of activations of the TSR 
program, which is set to zero when the TSR program is installed and incremented 
on each activation. This makes it clear that the cleanup function is actually 
executed in the installed TSR program and not in the program which performs the 
reinstallation. 


TSR development 


There are some procedures you should follow when developing TSR programs, 
that apply to the special characteristics of these programs. First, the program 
should be developed as a completely normal program, compiled and executed from 
the DOS user interface, or an interactive environment. To prepare for conversion to 
a TSR program, you can write an initialization routine and the actual TSR routine 
which will be called when the hotkey is pressed. Unlike the TSR version, you can 
call these routines in the main procedure/function of the program, allowing 
activation independent of any hotkeys. You should completely develop and test the 
program in this manner. Once it works correctly, you can convert it to a TSR 
program. 
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The conversion to a TSR program is relatively simple, and involves linking in the 
assembly language module to the program and calling the corresponding functions. 
You can see how this is done in detail in the two example programs. 


After linking the assembly language routines and converting the program to an 
EXE file, it should be started only from DOS. Do not start it from within an 
interactive environment like Turbo Pascal or Turbo C. 


The C implementation 
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Since TSR programs should use as little memory as possible, the assembly 
language interface was developed to be linked with the smallest C memory model 
(the small model). In both Microsoft and Turbo C compilers, the program code and 
data are placed in two separate segments, each of which may be no larger than 
64K. The data includes global and static data as well as the stack and the heap. As 
the following figures show, Turbo C and Microsoft C use different memory 
organization, despite their similarities. While in Turbo C the stack is placed 
behind the heap and moves from the end of the data segment to the end of the heap, 
the stack is between the global data and the heap in Microsoft C. 


Heap 
Heap 


Global & static data Global & static data 


Turbo C Microsoft C 


SS:SP FEFF (h) FFFF (h) 


max 64K max 64K 


$S:SP 


0000 (h) DS, SS,ES 0000 (h) 
max 64K 


cs 


max 64K 


Structure of a small model program (Turbo ClMicrosoft C) 


If this organization had no effect on the assembly language interface, we would be 
ready to allocate the entire 64K of the data segment resident in memory in addition 
to the program code. Since this would mean a significant waste of memory, and 
TSR programs should use as littke memory as possible, the assembly language 
should mark as resident only the part of the data segment which is actually 
required. 


The size of this memory area depends on the size of the data (or objects) which 
will be allocated on the heap by the functions callocQ) and malloc(. You must 
guess this size and pass it to the initialization routine so that the end of the 
required memory in the data segment can be calculated. 


This mechanism allows you to use the heap functions normally within the TSR 
program. Unfortunately, this applies only to the Turbo C compiler. Microsoft C 
uses an allocation algorithm which assumes that all of the memory to the end of 
the data segment is available, so allocating heap storage should be avoided within a 
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TSR program compiled with Microsoft C. You should allocate the buffers and 
variables required when the TSR program is initialized or place the required objects 
in global variables. The example C program allocates the two buffers it needs in 
the mainQ) function and then places the addresses of the buffers in global variables. 


There is something else you should be aware of when using Turbo C. Since the 
stack grows from the end of the 64K data segment to the heap, it finds itself 
outside the program when parts of the data segment are released again, and this in 
an area of memory which DOS may give to other programs. To avoid problems 
with this, the assembly language interface places the stack immediately after the 
heap, giving it 512 bytes of space. This should suffice for most applications, but 
may lead to problems if you use large objects (such as arrays) as local variables or 
pass them to other functions via the stack. In this case you should enlarge the 
stack by setting the constant TC_STACK in the assembly language interface to a 
larger value. 


The different treatment of the stack is the reason that the initialization routine in 
the assembly language interface must be told what compiler the TSR program will 
be compiled with. In practice you don't have to worry about this since it is handled 
within the C program with the help of constants defined with conditional 
preprocessor statements. 


The TSR initialization routine TSR_INIT must be called with the following 
parameters (in the specified order): 


° Compiler type (0 = Microsoft C, 1 = Turbo C) 

° Pointer to the C TSR function 

: Hotkey (mask for reading the BIOS keyboard flag) 
° Number of bytes to keep free on the heap 

. Pointer to an identification string 


The initialization routine uses the information about the compiler type and the 
number of bytes which must be available on the stack to calculate the number of 
paragraphs which must remain resident in memory. The C library function SBRK 
is Called from the assembly language routine to determine the offset address of the 
current end of heap. The number of bytes which must be reserved for the heap is 
added to this address. With Turbo C we also add the size of the stack, which 1s 
appended to the heap and must also stay resident. The result of this addition is the 
offset address of the last byte in memory relative to the start of the data segment. 


This address is converted to paragraphs by shifting it four places to the right, 
dividing it by 16. The result is the number of paragraphs which must remain 
resident in the data segment. In addition, there are the paragraphs from the PSP and 
the code segment. They can be calculated by subtracting the segment address of the 
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data segment (which is also the ending address of the code segment) and the 
segment address of the PSP. Since both Turbo C and Microsoft C store the 
segment address of the PSP in a global variable called _PSP, it can be read by the 
assembly language routine and included in the subtraction. The program is then 
ended by a call to DOS function 31H, which keeps the specified number of 
paragraphs (passed in the DX register) resident. The TSR program is installed. 


If a cleanup program is to be called when the program is reinstalled with the 
UNINST function, the UNINST function must be passed a pointer to this 
function. In C this is done simply by using the name of the function to be called 
as a parameter. 


If no such function is to be called, the argument -1 must be passed. Since this is 
not a valid function pointer, it must be preceded by the following cast operator: 


(void (*) (void)) -1 


There is a symbol, NO_END_FTN, defined with this expression in the C program 
which you can use in the call to UNINST. 


You can get additional information from the following listing. It will make a good 
basis for developing your own TSR programs. 


C listing: TSRC.C 
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[RRR KEKE REE KKK IKKE KEKE KEKE KEKE EK KEK KEK EK KEKE KEKE KKK KEE KEKKEKKEKEEKE / 


/* TSRC */ 
JR ea ah oe eet ae ee ee ee es x/ 
/* Description : C module which is turned into a TSR program */ 
/* with the help of an assembly language routine. */ 
ete i an Ste a ee ee ea ee a */ 
/* Author : MICHAEL TISCHER = 
/* developed on : 08/15/1988 +f 
/* last update : 08/19/1988 */ 
SPW niga a aaa a ei acca clea eae Dig ae a oh a ea ee eee x/ 
/* (MICROSOFT C) */ 
/* creation : CL /AS /c TSRC.C al 
/* LINK TSRC TSRCA; */ 
/* call : TSRC */ 
/* Se i ei ces eS i cis Ss no ea wins Scam sem wns sgn sans inn ns eps os ms anak Sls ec Gs Sm los no 'S es miu Qua tos mu iis scab dims om om ub ws as om ms a x/ 
/* (BORLAND TURBO C) */ 
/* creation : Create project file with the following */ 
/* contents: */ 
/* TSRC */ 
/* TSRCA.OBJ */ 
/* Before compiling, set Options menu / linker */ 
/* option / Case sensitive link to OFF */ 


[RRR ARR RIKKI KKK RIKKI HIER AKEKIKKER AKER REIKI AT IAT IKEA EE 


#include <stdlib.h> 
#include <dos.h> 


typedef unsigned char BYTE; /* build ourselves a byte */ 
typedef unsigned int WORD; 
typedef BYTE BOOL; /* like BOOLEAN in Pascal */ 
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typedef union vel far * VP; 


/* VP is a FAR pointer into the VRAM */ 


/ tox Macros SVS SSS SSS SS SS SEES AEM VESSEL VSS SSE SEES SS SS SSE t / 


#ifndef 


#define MK FP(seg, ofs) 


#fendif 


MK FP 


/* was MK FP already defined? */ 


#define VOFS(x,y) (80 * (y) +(x) ) 
#define VPOS (x,y) (VP) 


( vptr + VOFS( x, y) ) 


({void far *) ((unsigned long) (seg) <<16| (ofs))) 


struct velb { 


}; 


struct velw { 


WORD contents; 


}; 


attribute; 


/* describes a screen position as two bytes */ 
BYTE character, 


/* the ASCII code */ 
/* corresponding attribute */ 


/* describes a screen position as one word */ 
/* stores ASCII character and attribute */ 


union vel { /* describes a screen position */ 

struct velb h; 

struct velw x; 

}F 
/*== Link the functions from the assembly module ===========s==s=s=======%/ 
extern int is inst( char * id string ); 
extern void uninst( void (*fkt) (void) )}; 
extern int tsr_init (BOOL TC, void (*fkt) (void), unsigned hotkey, 

unsigned heap, char * id string); 
/*== ConStantS ===ss=ssssssssesssssssSsssaasSesSsSesssseeessseassssessast / 
#ifdef TURBOC __ /* are we compiling with TURBO-C? */ 
#define TC TRUE /* yes */ 
#felse /* we are using Microsoft C */ 
#define TC FALSE | 

#fendif 
/*-~- codes of the individual control keys for building the hotkey mask */ 
#define RSHIFT 1 /* right SHIFT key pressed */ 
#define LSHIFT 2 /* left SHIFT key pressed */ 
#define CTRL 4 /* CTRL key pressed */ 
#define ALT 8 /* ALT key pressed */ 
#define SCRL AN 16 /* Scroll Lock ON */ 
#define NUML AN 32 /* Num Lock ON */ 
#define CAPL AN 64 /* Caps Lock ON */ 
#define INS AN 128 /* Insert ON */ 
#define SCR LOCK 4096 /* Scroll Lock pressed */ 
#define NUM_LOCK 8192 /* Num Lock pressed */ 
#define CAP LOCK 16384 /* Caps Lock pressed */ 
#define INSERT 32768 /* INSERT key pressed */ 
#define NOF 0x07 /* normal color */ 
#define INV 0x70 /* inverse color */ 
#define HNOF Ox0f /* bright normal color */ 
#define HINV Oxf0 /* bright inverse color */ 
#define HEAP FREE 1024 /* leave 1K space on the heap */ 
#define TRUE, 1 /* constants for working with BOOL */ 
#define FALSE 0 


#define NO END FIN ((void (*) (void)) -1) /* don't call an end ftn. */ 


char id string[{] = “MiTi"; /* identification string */ 
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VP vptr; /* pointer to the first character in video RAM */ 
unsigned atimes = 0; /* number of activations of the TSR program */ 
union vel * scrbuf; /* pointer to the buffer with screen contents */ 
char * blank_line; /* pointer to a blank line */ 


[RRR KKEKKEREKKKKKEE KEKE KEKE KEKE KEKE EK KKK KEKE RKEKEKKEKKEKKKEEKKEKKKKKKEEK 


* Function :DISP_INIT * 
DEVE an sce ih sem is aes toes cee ea es Sah sek eis om an fits Saas ccs cs cases isin Ss ie ‘ass ne SS aes ea Gas ns cas a en de ca ems med oe cs ee ee x* 
* Description : Determines the base address of the video RAM. * 
* Input parameters : none * 
* Return value : none * 


HHKKKK HERE EKIRKE KEKE KEK KERR KKK IEEE KEKE EKER AER KEKKKEEEKEEKKEAKKKEKKKKKE / 


void disp init (void) 
{ 


union REGS regs; /* processor regs for the interrupt call */ 
regs.h.ah = 15; /* function number: determing video mode */ 
int86(0x10, &regs, &regs); /* call the BIOS video interrupt */ 


/* calculate base addr of the video RAM according to the video mode */ 


vptr = (VP) MK FP((regs.h.al == 7) ? Oxb000 : Oxb800, 0); 
} 


[RAIA IKI KIKI KARRI KKK IKK AKER AE KKK EKER AIA AEE 


* Function > D 1.8 P.. PRINT x 
FOI ee ec a a i a a a a i ead aes a et a a a a a a a i a es a es a ee ws ae a ne ee en es ws kk 
* Description : Output a string to the screen. * 
* Input parameters : - COLUMN = the output column * 
- - LINE = the output line * 
~ - COLOR = attribute for the characters x 
* - STRING = pointer to the string * 
* Return value : none i 


HAKKAR KKK KEK KKK KKK KEKE KEKE KKK IKKE KEKE KEKE KRKKKEKKKEKEKKKEKAKE / 


void disp print (BYTE column, BYTE line, BYTE 
color, char * string) 
{ 
register VP lptr; /* running pointer for accessing the video RAM */ 


lptr = VPOS(column, line); /* set pointer to the video RAM */ 
for ( ; *string ; ++lptr) /* run through the string */ 
{ 
lptr->h.character = *(string++); /* write char into the video RAM */ 
lptr->h.attribute = color; /* set attribute for the character */ 
} 


} 


[RRR KKIIKKAKKKKR HIKE KEK KK KAKA KEKE AK KERR KKK KKEKEREKEKKKKKKKKKK 


* Function > SAVE SCREN i 
IE We ss aks a cn se eS Ss cee secs teense kes is Ss Sas aa sts aw tacs sd aes sow a ees eed es es es ee iin ee eee ea See ee kk 
* Description : Saves the screen contents in a buffer. * 
* Input parameters : - SPTR = pointer to the buffer in which the * 
= screen will be saved. * 
* Return value : none * 
* Info : It is assumed that the buffer is large enough to * 
* hold the screen contents. 


RHRKKKEK KEK KEK KEK KKK KKK KEIR KK KEK KEKE KKK KKK EK KEK AEK KERR IKEKREKKKEKEKKKKKEK KR / 


void save_screen( union vel * sptr ) 


{ 
register VP lptr; /* running pointer for accessing the video RAM */ 


unsigned i; ’ /* loop counter */ 
lptr = VPOS(0, 0); /* set pointer in the video RAM */ 
for (i=0; 1<2000; i++) /* run through the 2000 screen positions */ 


(sptr++)->x.contents = (lptr++)->x.contents; /* save char. & attr. */ 


} 
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[RRR III RHI KK IK KIKI KK IKI KK IKK IKE KKK KEKE KEKE EKER E KEKE KKK KKKKKK KKK 


* Function >RESTORE SCREEN - 
IE a a tae is ea a a ni es ens se ane eos ees Sas as is i en ns i ei ne ee es sem mein eee see ee ed ta ln Smt ow ms nes ed kk 
* Description : Copies the contents of a buffer into the video * 
* RAM. * 
* Input parameters : -— SPTR = pointer to the buffer in which the * 
* . screen contents are located * 
* Return value : none * 


HHH KKK IKK IKI KIKI KEKE KIKI IKI KIKI KEITH AREER IKE KIKI AKIK KEK / 


void restore screen( union vel * sptr ) 


{ 


register VP lptr; /* pointer for accessing the video RAM */ 
unsigned i; /* loop counter */ 
lptr = VPOS(0, 0); /* set pointer to the video RAM */ 
for (1=0; 1<2000; i++) /* run through the 2000 screen positions */ 


(lptr++)->x.contents = (sptr++)->x.contents; /* restore char.éattr.*/ 


} 


[RRA KEKE KKK EE KEK KEK KKK KKK EKER KEK KEK KEKE KEKKKKKEEKKKKEKEK EK 


* Function >: ENDFTN * 
SR OIG x pens ns ass en isc micah sie spn eS esos a ig et td e-waste nS tS ih tains lin ick cn i nh ll i i ipl as Se ily la i ot ea oe kk 
* Description : Called when the TSR program is reinstalled. x 
* Input parameters : none = 
* Return value : none * 


IK KRHA IK KIKI KKK KKK KIKI IKKE KKK KKK IK IKIK HERE KK ERK KKK KEKE KEKE KKKKEEKKKKK | 


void endftn( void ) 
{ 


/*-- release the allocated buffers -----~--------------------- <9 -— al 
free( blank_line ); /* release the allocated buffer */ 
free( (void *) scrbuf ); /* release the buffer */ 


printf ("The TSR program was activated %u times.\n", atimes) ; 
} 


[RRR KKKKK KEKE KK KKK KKK KER KEKE KEKE KEK KEK KEE KKK EK KEEK ERK KKK KKK KKK KEKE KKEEKKKKK 


* Function 2 TSR x 
De IC ee Sen i eae ew ask en en ee er a ab ais cts tin “is ie em ‘nb oe es ew ee we es ea cee ne sea ew is nw es os ce esas en ew Ge ence ses ee oe kk 
* Description : Called by the assembler routine when the hotkey * 
* is pressed. * 
* Input parameters : none x 
* Return value : none ba 


HRI IKI KK RIKKI KEKE KEK KEE KKK KKK KEK KKK KKK IKKE KK ERE EEK EKKKEKKEKKEKKEK KK / 


void tsr( void ) 
{ 


BYTE i; /* loop counter */ 
++atimes; /* increment the number of activations */ 
disp init(); /* determine address of the video RAM */ 
save_screen( scrbuf ); /* save the current screen contents */ 
for (i1=0; 1<25; i++) /* run through the 25 screen lines */ 
disp print (0, i, INV, blank line); /* clear the line */ 
disp print (22, 11, INV, “TSRC - (c) 1988 by MICHAEL TISCHER") ; 

disp print (28, 13, INV, “Please press a key ..."); 

getch(); /* wait for a key */ 
restore screen( scrbuf ); /* copy the old screen back */ 


} 


[RRR REE KEKE KKK AKI KIRKE RK IKI IKKE KEK EKER KEKEKRKEEKKKKEKEKAKKEKKK KK / 


7 Xx _ MAIN PROGRAM S/ 
[ RRR ERE REIKI KKK IKK IKK KKK IK EI IKK IKKE IKKE RIK IKARIA IRAE / 


void main () 


{ 
printf("TSRC - (c) 1988 by MICHAEL TISCHER\n\n") ; 
if ( is_inst( id_string ) ) /* is the program already installed? */ 
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{ /* yes */ 
printf ("TSRC was already installed--now disabling.\n") ; 
uninst ( endftn ); /* reinstall prg., call ftn. ENDFKT */ 


/*-- if no end function is to be called, the call is: ------------- */ 
/*-- uninst( NOLEND FTN )p 000 tee ate pen */ 


else /* no, the program has not been installed yet */ 


{ 
/*-- with MSC the heap buffers must be allocated now --<------------ */ 


scrbuf = (union vel *) malloc(80 * 25 * sizeof(union vel)); 

blank_line = (char *) sbrk( 80 + 1 }7 /* allocate buffer */ 
*(blank_line + 80 ) = '\O'; /* terminate buffer with NUL */ 
memset (blank line, ' ', 80); /* £111 the buffer with spaces */ 


printf ("TSRC now enabled - Start: <LSHIFT> + <RSHIFT>\n") ; 
tsr_init(TC, tsr, RSHIFT | LSHIFT, HEAP FREE, id_string); 


Assembler listing: TSRCA.ASM 


FERRER HKKKEK ERK ERK ERK KEKE KK REE KEKE KKK KEKE KRKKEKEKKKEKKEKKEKKEERKEKKKKKKEEKKKKE 9 
7% TSRCA *; 
res css imi es ius can tie os i wh is saan nels in einem ns bs cps Sic as eb hun mms cs a nua Se a emus san eas Ss i en mma emis am es Sn Sn late Ss “en time ei eum es as 
on Description : represents the assembler interface to a “3 
he C program which can be activated by a hotkey le 
pt as a TSR program. *3 
as et i ini i i emi a a: ma a eS Ge we. ie: ks ht l,i Su eS ‘eel he epi St iti se: a! a nie: iwi tte: iui spi thw i a ci wih et oe ise x3 
rigs Author : MICHAEL TISCHER ba 
3% developed on : 08/10/1988 ny 
oe last update : 05/26/1989 *s 
Oe es ss ee a a a ee eS a i a Se a se ee SS as a a a ae es Se ee a xe 
f v 
sx to assemble : MASM TSRCA; ie 
;* -.. combine with C program * 
FRR R AREA EERE KKK KKK KERR KK KKK KEK KEK KAKA KKK KKK KEK KKK KKKEKKEKKKEKKE 8 


IGROUP group text ;combination of program segments 
DGROUP group const, bss, data ;combination of data segments 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public ‘CONST';this segment holds all read-only 
CONST ends sconstants 


_BSS segment word public 'BSS‘ ;this segment stores all uninitialized 
_BSS ~~ ends static variables 


_DATA segment word public ‘DATA‘t ;all initialized and global static 
jvariables are stored in this 


7 segment 
extrn — psp : word segment addr of the PSP of the C prg 
_DATA ends 
MAX_ID LEN equ 16 ;maximum length of the ID string 
TC_STACK equ 512 7212 bytes are reserved for) the stack 
7with TURBO-C yl 
| 
| 


| 


_TEXT segment byte public 'CODE' ;the program segment 
;-- Reference to external (C) functions -~------------------------------ 


extrn _sbrkinear ;returns end address of the heap 
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;-- Public declarations of internal functions -------------------------- 
public _tsr init vallows call from C program 

public _is inst 

public _uninst 

;-- Variables for the interrupt handler -------------------------------- 
j-- (only accessible via the code segment) ----------------- <9 
id_ buf db (MAX_ID LEN + 1) dup (0) ;buffer for the ID string 

ce ptr equ this dword ;points to the routine CALL END 

ce ofs dw offset call end zin the already-installed TSR program 
ce seg dw ? 


;~- Variables needed for activation of the C program -------------~------ 


c_ss dw 0 7C stack segment 

c sp dw 0 7C stack pointer 

c_ds dw 0 7;C data segment 

c_es dw 0 7C extra segment 

c dta_ ofs dw 0 7DTA address of the C program 


c dta_seg dw 0 


c psp dw 0 ;segment addr of the PSP of the C prg 
break_adr dw 0 ;break address of the heap 
fkt_adr dw 0 ;address of the C TSR function 


;-- Variables for testing for the hotkey ------------------------=--=--- 


key mask dw 0 ;hotkey mark for BIOS keyboard flag 

recur db 0 ;prevents recursive TSR calls 

in_ bios db 0 ;shows activity of the BIOS disk 
;interrupt 

daptr equ this dword ;pointer to the DOS Indos flag 

daptr ofs dw 0 ;offset address 

daptr seg dw 0 7segment address 


-- The following variables store the old addresses of the interrupt --- 
-- handler, which will be replaced by the new interrupt handler -—— 


e 
s 
e 
s 


int9 ptr equ this dword 7old interrupt vector 9h 

int9 ofs dw 0 ;offset address of the old handler 
int9 seg dw 0 ;segment address of the old handler 
int13 ptr equ this dword ;old interrupt vector 13h 

int13 ofs dw 0 ;offset address of the old handler 
intl3 seg dw 0 ;segment address of the old handler 
int28 ptr equ this dword 7old interrupt vbector 28h 

int28 ofs dw 0 roffset address of the old handler 
int28 seg dw 0 7;segment address of the old handler 


y-- Variables which store the information of the interrupted -----~----~- 
P—-- Program, a a a a 


u_dta ofs dw 0 ;DTA address of interrupted program 
u_dta_seg dw 0 


u_psp dw 0 ;segment addr of the PSP of int. prg. 


uprg ss dw 0 7SS and SP of the interrupted prg. 
uprg sp dw 0 


;-- TSR_INIT: ends the C program and makes the new interrupt ----------- 
;—7 interrupt handler active 
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7-- Call from C: void tsr_init ( bool TC, 
j-- void (fkt *) (void), 
i-> int key mask, 
i-- unsigned heap byte, 
== char * id string ); 
_tsr init proc near 
sframe0 struc sstructure for accessing the stack 
bpd dw ? sstores BP 
ret_adrO dw ? 7return address 
tc0 dw ? ;compiler (1 = TURBO-C, O = MSC ) 
fktptr0 dw ? spointer to C TSR function 
keymaskO dw ? ¢mask for hotkey 
heapo dw ? zheap bytes required 
idptr0 dw ? ;pointer to the ID string 
sframeO ends send of the structure 
frame equ [ bp - bpd ] 
push bp ;store BP on the stack 
mov bp,sp 7move SP to BP 


;-- save the C segment registers ---~-~-----—----------------— 
mov cCS:C_Sss,Ss ;store the registers in the 

mov cCS:C_Sp,sp ;corresponding variables 

mov cCS:C_es,es 

mov cs:c_ds,ds 


j-- copy the ID string into the internal buffer ------------- 


mov si,frame.idptr0 7DS:SI now points to the string 


push cs smove CS to the stack 

pop es zand restore as ES 

mov di,offset id buf ;ES:DI now points to ID_BUF 

mov cx,MAX ID LEN ;copy maxmimum of MAX ID LEN chars 
tid: lodsb rget character from string 

stosb gand place in internal buffer 

or al,al ;test for end of string 

loopne tid ;continue if char!=0 and CX!=0 


;~-- store the parameters passed ------------------------~--- 


mov ax,frame.fktptrO j;get pointer to the C TSR function 


mov cs:fkt_adr,ax ;and save 
mov ax, frame.keymaskO ;get mask for hotkey 
mov cs:key mask, ax zand save 


;-- determine DTA address of the C program ---~---— 


mov ah, 2fh ;ftn. no.: get DTA address 

int 21h :call DOS interrupt 

mov cs:c_dta ofs,bx ;store address in the corresponding 
mov cs:c_dta_seg,es ;variables 


7~- determine address of the INDOS flag --------------------- 
mov ah, 34h ;ftn. no.: get addr of the INDOS flag 
int 21h 7call DOS interrupt 

mov cs:daptr ofs,bx ;save address in the corresponding 


mov cs:daptr_seg,es ;variables 


7-- get the addresses of the interrupt handler ------------- 


mov ax,3509h 7get interrupt vector 9h 

int 2lih 7call DOS interrupt 

mov cs:int9 afs,bx ;save address of the handler in the 
mov cs:int9 seg,es zappropriate variable 
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mov ax,3513h ;get interrupt vector 13h 

int 21h ;call DOS interrupt 

mov cs:intl3 ofs,bx ;store address of the handler in the 
mov cs:intl3_seg,es ;corresponding variables 

mov ax,3528h 7get interrupt vector 28h 

int 21h 7call DOS interrupt 

mov cs:int28 ofs,bx ;store address of the handler in the 
mov cs:int28 seg,es ;corresponding variables 

7-- install the new interrupt handlers --------------------- 
pusn ds 7Save data segment 

MOV ax,cCs 7CS to AX and then load into DS 

mov ds,ax 

mov ax, 2509h ;ftn. no.: set interrupt 9h 

mov dx,offset int09 7DS:DX stores the addr of the handler 
int 21h 7call DOS interrupt 

mov ax,2513h 7ftn. no.: set interrupt 13h 

mov dx,offset int13 7DS:DX stores the addr of the handler 
int 21h 7call DOS interrupt 

mov ax, 2528h 7ftn. no.: set interrupt 28h 

mov dx,offset int28 7DS:DX stores the addr of the handler 
int 2ih zcall DOS interrupt 

pop ds ;restore DS from stack 


calculatre number of paragraphs which must remain ------- 
im memory, ee nr 


xOr ax,ax ;determine current break address 
push ax 7as argument for SBRK on the stack 
call _sbrk ;call C function SBRK 

7;AX contains the end addr of the heap 
pop cx ;get argument from stack again 
add ax, frame.heap0 ;add required heap memory 
7-- With TURBO-C the stack is found behind the heap and ----- 
7~-- begins with the end of the segment. It must thus 
7-- be moved near the heap. 
cmp byte ptr frame.tc0O,0 ;using TURBO-C? 
je msc zno, MSC 
add ax,TC_ STACK~-1 ;calculate new stack pointer for TC 
mov cCS:C_sp,ax zand store 
inc ax ;set break address 
7-~ Calculate number of paragraphs which must remain -------- 
7-~ resident in memory. 

msc: mov dx,ax ;get break address into Dx 

add dx,15 ;avoid loss through integer division 
mov cl,4 rshift 4 times to the right and then 
shr dx,cl ;divide by 16 
mov ax,ds 7move AX to DS 
mov bx, psp 7get segment address of the PSP 
mov cs:c_ psp, bx j;save ina variable 
sub ax,bx ;subtract DS from PSP 
add dx,ax yand add to the number of paragraphs 
mov ax,3100h ;ftn. no.: end resident program 
int 21h 7call DOS interrupt and end program 


_tsr_init endp 
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z-- IS_INST: determines if the program is already installed 
int ist_inst( char * id_string ); 


j-- Call from Cc : 


; Return value: 1, if the program was already installed, else 0 


;structure for accessing the stack 
zhold BP 

;return address 

;pointer to the ID string 

;end of the structure 


7save BP on the stack 
z7move SP to BP 

;save DI on the stack 
7save SI on the stack 
;save ES on the stack 


7-~- determine segment address of the current int 9 handler -- 


_is inst proc near 
sframel struc 
bp1 dw ? 
ret_adrl dw ? 
idptrl dw ? 
sframel ends 
frame equ [ bp - bpl ]} 
push bp 
mov bp,sp 
push di 
push si 
push es 
mov ax,3509h 
int 21h 
mov di,offset id_buf 
mov si, frame.idptrl 
mov cx,0 
isid: lodsb 
cmp al,es: [di] 
jne not_inst 
inc di 
or al,al 
jne isid 
mov cl,l 
not_inst: mov ax,cx 
pop es 
pop si 
pop di 
pop bp 
ret 
is inst endp 


=e “es “se “Re Se 


a program. 

-- Input : DI = 

~- Info : 

call_end proc far 
call di 
ret 

call end = endp 


sget interrupt vector 9h 

7;DOS interrupt puts seg addr in ES 
7ES:DI points to installed ID_BUF 
7DS:SI points to the ID_STRING passed 


;return code: not installed 
;load character from the string 
;compare to other string 

7not equal --> NOT_INST 
zincrement pointer in String2 
zend of string reached? 

7no, keep comparing --> ISIO 


zyes --> the program is installed 


;get return code from ax 
;restore saved registers from stack 


sback to the caller 


send of the procedure 


~~ CALL END: calls the end function on reinstallation of the TSR -----~ 


offset address of the routine to be called 
This function is not intended to be called by a C program. 


7;call the end function 
;back to the caller 
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~~ UNINST: reinstalls the TSR program and releases the allocated 


~- Info 


=e Ss “ses Ne Be Ve Vs 


-- Call from cC 


memory again. 

: void uninst( void (endfkt *) ( void ) ); 

: if the value -1 (Oxffff) is passed as the pointer to 
the end function, no end function will be called. 


~- Note : This function should be called only when a prior call 
= to IS _INST() has returned the value 1. 

_uninst proc near 

sframe2 struc ;structure for accessing the stack 
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bp2 
ret_adr2 
ftnptr2 
sframe2 


frame 


aaa 
z£ze 
Vm w 


ends 


equ [ bp —- bp2 ]} 


assume es: IGROUP 


push 
Mov 

push 
pusn 
push 
push 


bp 
bp, sp 
di 
Si 
ds 
es 


;stores BP 

;return address 

;pointer to the end function 
zend of the structure 


sallow access to the CS variables 
;via ES 


;save BP on the stack 
;move SP to BP 

;store DI on the 
;store Si on the 
;store DS on the 
; store ES on the 


stack 
stack 
stack 
stack 


7-- determine the seg addr of the current int 9 handler --- 


mov 
int 


mov 


cmp 
je 


ax, 3509h 
21h 


di, frame. ftnpt r2 
di, Offffh 
no_endftn 


Perform context switch to C program and execute 


7get interrupt vector 9h 
7;DOS interrupt puts seg addr in ES 


;get address of the end function 
sno end function called? 
;NO ~--> NO_ENDFTN 


j-- the specified end funtion 


mov 
mov 
call 


cs:ce seg,es 


cs:uprg_ss,ss 
cs:uprg_sp,sp 


Ss,esS:c_ss 
sp,es:c_sp 


es 
ah, 2fh 

21h 

cs:u_dta ofs,bx 
cs:u_dta_seg,es 
es 


ah, 50h 
bx, eS:c_psp 
21h 


ds 


es 


ah, lah 
dx,es:c_dta ofs 
ds,es:c_dta_seg 
21h 


ds,es:c_ds 
es,eS:c_es 
cs: [ce_ptr] 


zsave ES in jump vector 


7save current stack segment and 
;stack pointer 


z;allow no more interrupts 
sactivate the stack of the TSR 
7; program 

sallow interrupts again 


;save ES on the stack 

;ftn. no.: get DTA address 
7call DOS interrupt 

;save address of the DTA of the 
;interrupted program 

sget ES back from the stack 


s;ftn. no.: set address of the PSP 
7get seg addr of the PSP of the C prg 
7call DOS interrupt 


;save ES and DS on the stack 


;ftn. no.: set DTA address 

rget offset address of the new DTA 
yand segment address of the new DTA 
7call DOS interrupt 


7set segment register for the 
7C program 
;call the function 


7~- perform context change to the interrupt program ------- 


ah, lah 
dx,cs:u_dta ofs 
ds,cs:u_dta_seg 
21h 


es 
ds 


7ftn. no.: set DTA address 

zload offset and segment address of 
zthe interrupted program 

7call DOS interrupt 


7seg addr of the TSR prog from stack 
;restore DS from stack 
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mov ah,50h ;ftn. no.: set address of the PSP 
mov bx, psp zload seg addr of the PSP 

int 21h jcall DOS interrupt 

cli jdon't allow interrupts 

mov ss,cCs:uprg_ ss srestore stack pointer and stac 
mov sp,cs:uprg sp 7 segment 

sti sallow interrupts again 


7-- reinstall the interrupt handler of the TSR -------------- 
fo~ program 4 aera ee me 


no_endftn: cli ;don't allow interrupts 
mov ax,2509h sftn. no.: set handler for int 9 
mov ds,es:int9 seg 7;segment address of the old handler 
mov dx,es:int9 ofs ;offset address of the old handler 
int 21h zinstall the old handler again 
mov ax,2513h ;ftn. no.: set handler for int 13 


mov ds,es:intl3_ seg ;segment address of the old handler 
mov dx,es:intl3 ofs j;offset address of the old handler 
int 21h ;reinstall the old handler 


mov ax, 2528h sftn. no.: set handler for int 28 
mov ds,es:int28 seg ;segment address of the old handler 
mov dx,es:int28 ofs ;offset address of the old handler 


int 21h ;reinstall the old handler 

sti sallow interrupts again 

mov esS,eS:C_psp ;seg addr of the PSP of the TSR prg 

MOV CxX,eS ;save in CX 

mov es,es:[{ 02ch ] sget seg addr of environment from PSP 

mov ah,49h ;ftn. no.: release allocated memory 

int 21lh 7call DOS interrupt 

mov eS,CxX ;restore ES from CX 

mov ah,49h ;ftn. no.: release allocated memoru 

int 21h 7call DOS interrupt 

pop es zget the saved registers back from 

pop ds 7the stack 

pop si 

pop di 

pop bp 

ret zback to the called 

assume es:DGROUP ;combine ES with DGROUP again 
_uninst endp send of the procedure 


;-- The new interrupt routine follows -------------------------<--------- 


z-- The new interrupt 09h handler -----------------------~~--~+----------- 


intd9 proc far 
pushf 7simulate the call of the old handler 
call cs:int9 ptr via the INT 9h instruction 
cli ;suppress interrupts 
cmp cs:recur,0 zis the TSR prog already active? 
jne ik_end 7YES: back to the called of int 9 


7-~ test to see if the BIOS disk int is being executed now 


cmp cs:in bios,0 ;BIOS disk interrupt active? 
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ik_end: 


into9 


int13 


jne ik _end ryes --> back to the caller 

z-- BIOS disk interrupt not active, test for hotkey -------- 
push ax ;save ES and AX on the stack 

push es 

xOr ax,ax ;set ES to the lowest memory segment 


mov es,ax 
mov ax,word ptr es:({417h] ;get BIOS keyboard flag 


and ax,cs:key mask ;mask out the non-hotkey bits 
cmp ax,cs:key mask yare only the hotkey bits left? 
pop es ;get ES and AX 

pop ax 

jne ik_end ;hotkey discovered? no --> back 


;-~- the hotkey was pressed, test to see if DOS is active --- 


push ds ;save DS and BX on the stack 

push bx 

lds bx,cs:daptr 7DS:BX now point to the INDOS flag 
cmp byte ptr [bx],0 ;DOS function active? 

pop bx ;restore BX and DS from the stack 
pop ds 

jne ik_end ;DOS function active --> IK END 


7-- DOS is not active, activatr TSR program ------~---------- 


call start _tsr ;Start the TSR program 

iret rback to the interrupted program 

endp 

7-- the new interrupt 13h handler -------------~------------------------- 

proc far 

mov cs:in bios,1 ;set flag and show that the BIOS disk 
;interrupt is active 

pushf 7call the old interrupt handler 

call cs:int13 ptr ssimulate via int 13h 

mov cs:in bios, 0 ;BIOS disk interrupt no longer active 

ret 2 sback to the caller, but don't remove 
;the flag reg from the stack first 

endp 


int13 


;-- the new interrupt 28h handler --------------<---=---<-------=-----==- 


int28 


id_end: 


idol: 


proc far 

pushf ;simulate calling the old interrupt 
call cs:int28 ptr handler via int 28h 

cli ;suppress further interrupts 

cmp cs:recur,0 zis the TSR program already active? 
je id01 7;NO -~-> IDO1 

iret 7YES ---> back to the caller 


;-~- the TSR program is not yet active ---------------------- 


cmp cs:in_bios, 0 ;BIOS disk interrupt active? 
jne id _end 7;YES --> back to the caller 


;-~- BIOS disk interrupt not active, test for hotkey -------- 


push ax ;save ES and AX on the stack 
push es 
xOr ax,ax 7st ES to the lowest memory segment 


mov eS,ax 
mov ax,word ptr es:[417h] ;get BIOS keyboard flag 
and ax,cs:key mask rmask out the non-hotkey bits 
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int28 


cmp 
pop 


pop 
jne 


call 
iret 


endp 


ax,cs:key_ mask 


es 
ax 
ik_end 


start_tsr 


gare only the hotkey bits left? 
zrestore ES and AX 


shotkey discovered? NO --> back 


;start the TSR program 
zback to the interrupted program 


7-- START TSR: activate the TSR program ------------------------------ 


start_tsr proc near 


tsrsl: 


mov 


cs:recur,1 


;set TSR recursion flag 


¢7~ perform context change to the C program ----------------~ 


mov 
Mov 


mov 
mov 


push 
push 
push 
push 
push 
push 
push 
push 
push 


cs:uprg_ss,ss 
cs:uprg sp, sp 


Ss,cs:c_ss 
sp,cs:c_sp 


ax 
bx 
cx 
dx 
bp 
si 
di 
ds 
es 


save 64 words from 


cx, 64 
ds,cs:uprg_ss 
si,cs:uprg_ sp 


word ptr [si] 
si 

si 

tsrsl 


ah, 51h 
21h 
cs:u_psp, bx 


ah, 2fh 
21h 


cs:u_dta ofs,bx 
cs:u_dta_seg,es 


ah, 50h 
bx, cS:C_psp 
21h 

{ 


ah, lah 


dx,cs:c_dta_ofs 
ds,cs:c_dta_ seg 


21h 


ds,cs:c_ds 
es,Cs:ic_es 


cs: fkt_adr 


;save current stack segment and 
;stack pointer 


sactivate the C program's stack 


zsave the processor registers on the 
7C stack 


the DOS stack -------------+----------- 


zloop counter 
sset DS:SI to the end of the DOS stack 


s;save word from the DOS stack to the 
7;C stack and set SI to the next 
7;stack word 

7process all 64 words 


;ftn. no.: determine address of PSP 
7call DOS interrupt 
;save segment address of the PSP 


;ftn. no.: get DTA address 

7call DOS interrupt 

;store address of the DTA of the 
pinterrupted program 


;ftn. no.: set address of the PSP 
zget seg addr of the\PSP of the C prg 
7call DOS interrupt 


;ftn. no.: set DTA address 

;get offset address of the new DTA 
zand the segment address' of new DTA 
7call DOS interrupt 


;set segment register for the C 
7 program 


jallow interrupts again 
7call the start function of the C prg. 
;disable interrupts 
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z~-- perform context change to the interrupted program --~---- 


mov ah,lah sftn. no.: set DTA address 
mov dx,cs:u_dta ofs ;load offset and segment addresses 
mov ds,cs:u_dta_ seg sof the DTA of the interrupted program 


int 21h ;call DOS interrupt 

mov ah,50h ;ftn. no.: set address of the PSP 

mov bx,cs:u_psp zseg addr PSP of the interrupted prg. 

int 21h 7call DOS interrupt 

j-~- restore DOS stack again ------3------- 9-99 

mov cx, 64 ;loop counter 

mov ds,cs:uprg ss jload DS:SI with the end address of 

mov si,cs:uprg sp 7the DOS stack 

add si,128 sset SI to the start of the DOS stack 
tsrs2: dec si 7SI to the previous stack word 

dec si 

pop word ptr [si} ;get word from the C stack to DOS stack 

loop tsrs2 ;process all 64 words 

pop es ;restore the saved registers from the 

pop ds 7C stack 

pop di 

pop si 

pop bp 

pop dx 

pop cx 

pop bx 

pop ax 

mov sS,CS:uprg_ ss ;reset stack pointer and stack segment 

mov sp,CsS:uprg_sp 7;of the interrupted program 

mov cs:recur,0 ;reset TSR recursion flag 

ret ;back to the caller 


start tsr endp 


_text ends rend of the code segment 
end 7end of the program 


Turbo Pascal offers only one memory model, unlike the various C compilers. The 
organization of this model is well suited to TSR programs. 


Free Ptr ao > 


Heap 


_ increasing 
Global variables 
memory 
Predefined constants 
addresses 


Runtime library routines 


Additional unit routines 


Program code 


Prefix Seg 


Memory layout of a Pascal program under Turbo Pascal 4.0 
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The figure above shows that the program code and the required routines from the 
various units and the runtime library follow the PSP. After these are the predefined 
constants, the global data, and the stack segment. While the size of these program 
components are set at compilation and cannot be changed after the program is 
loaded into memory, this doesn't apply to the size of the heap, which follows the 
stack segment. When new objects are created with the NEW command, the heap 
grows toward the end of memory. 


Turbo Pascal offers the significant advantage over C compilers of being able to set 
the maximum size of the heap, as well as the stack size, with a compiler directive 
inside the source code. This is the $M directive, which must be passed the 
following parameters: 


{SM stack size, minimum heap size, maximum heap size} 
All specifications are in bytes, so the directive 
{SM 2048, 0, 5000} 


results in a 2K stack and a maximum 5000-byte heap. If no such directive is found 
in a program, the heap is not limited and it can grow to the end of main memory. 
This would have catastrophic results for a TSR program, however, since the entire 
memory would have to be reserved for the TSR program and there would be no 
memory left for additional programs. But with the $M directive placed at the 
beginning of the program, we can set the maximum size of the program in 
memory and the number of paragraphs which must remain resident after the 
program is terminated. 


Turbo Pascai also allows the number of paragraphs to be reserved to be calculated 
from the Pascal program, eliminating the complicated calculation in the assembly 
language interface. In a C program, important data needed for this calculation 
(segment addresses of the PSP and data segment, and size of the heap) are available 
only at the assembly language level, but Turbo Pascal places this information in 
normal variables, which are available to a Pascal program in the form of pointers. 
For our purposes, we need the starting address of the PSP and the end of the heap, 
since they mark the start and end of the TSR program in memory. 


The figure shows that the segment address of the PSP is found in the variable 
PrefixSeg, while the end of the heap is determined with the help of the pointer 
variable FreePtr. This variable does not point directly to the end of the heap, but 
the segment portion of this pointer contains the end address of the heap minus 
$1000. This information is used within the TSR program in the ResPara 
procedure, which calculates the number of paragraphs to remain resident after the 
installation of the TSR. 
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In addition to this information, the initialization routine TsrInit in the assembly 
language module must be passed the following information (in the specified order): 


° Address of the Pascal TSR function 

2 Hotkey (mask for reading the BIOS keyboard flag) 
° Number of paragraphs to be reserved 

° Identification string 


The Pascal TSR function, the address of which is passed as the first parameter to 
TsrInit, must be a procedure within the main program and may not be contained in 
a unit. Moreover, it may not be converted to a FAR procedure with the $F+ 
compiler directive, since the assembly language interface assumes that it is a 
NEAR procedure. The address of the procedure is determined with the help of the 
function OFS and passed to TsrInit, since Turbo Pascal would otherwise place 
both the offset address and the segment address on the stack. 


The same applies to passing the address of a "cleanup" procedure to the function 
UniInst, which reinstalls the TSR program. If such an address is passed, the 
corresponding procedure within the installed TSR program will be called before the 
reinstallation. If the value $FFFF is passed as the address of this procedure, this 
tells the assembly language function that no "cleanup" procedure is to be called. 
To improve the readability of the listing, the constant NO_END_FTN is defined in 
the constant definitions at the start of the listing. NO_END_FTN is given the 
value $FFFF and should be used when calling the assembly language function 
UnInst. 


The following listing can answer any additional questions you may have, and will 
make a good starting point for your own TSR programs. 


listing: TSRP.PAS 


{ RR AHERHARHEEKRKEKEREEEREREKREEREREEKEKEEEKKKEREREKKEKERKKEEKRKEKREKREREREKEREKKE | 


{* TSRP *} 
(Reece a a a i oe ee eee *} 
[= Description : creates a TSR program with the help of an | 
Le assembly language module. | 
{* a ec ct ee ee Se ee DD ED aS oc ne SS Yc SS) ND SD SE GS ERD SAT SY DO YD ee eae *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 08/18/1988 i 
{* last update : 05/26/1989 *} 


{RA RRRRKHHEKRKKEREHEKK EKER KEK KEERERERK RRR EKEREKEREKKRE ERE KKK EKEEKRKEEKEKEREKE | 


program TSRP; 


uses DOS, CRT; { bind in the DOS and CRT units } 
{SM 2048, 0, 5120} { 2KB for the stack and max. 5KB for the heap } 
{$L tsrpa} { bind in the assembler module } 
const LSHIFT = i { left SHIFT key } 
RSHIFT = 2: { right SHIFT key } 
CTRL = 4; { CTRL key } 
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ALT = 8; { ALT key } 
SYSREQ = 1024; { SYS REQ key (ST keyboard only) } 

BREAK = 4096; { BREAK key } 

NUM = 8192; { NUM key } 

CAPS = 16384; { CAPS key } 
INSERT = 32768; { INSERT key } 
NO_END FIN = SFFFF; { don't call an end function } 

type IdsType = string[ 16 ]; { describes the identification string } 
VBuf = array(1..25, 1..80] of word; { describes the screen } 

vPtr = “VBuf; { pointer to a screen buffer } 

var IdString : IdsType; { the ID string for the TSR program } 
MBuf : VBuf absolute $B000:0000; { the monochrome video RAM } 
CBuf : Vbuf absolute $B800:0000; { the color video RAM } 
VioPtr : VPtr; { pointer to the video RAM } 


{** Declaration of the external functions in the assembly module ******} 


procedure TsrInit( PrePtr : word; { offset addr of the TSR proc } 
KeyMask : word; { the hotkey (see CONST) } 
ResPara : word; { number of para. to be reserved } 
IdString : IdsType ) ; external ; { the ID string } 


function IsInst ( IdString : IdsType ) : boolean ; external ; 


procedure UnInst( PrcePtr : word ); external; { reinstall TSR program } 


var ATimes : integer; { number of TSR activations } 


{RRR EEKK ERE RER EER EER EKER ERE REE EKREREKKEEREKEEKEKEKEEE | 
{* DispInit: creates a pointer to the video RAM *} 
{* Input : none *} 
{* Output : none *} 
[RR RR REE REE RRR ER KR E RRR KRK KERR REE ERE ERK KER ERE KKK EERE KEKE KKKEEKEREKEKKEKEKE | 


procedure DispInit; 


var Regs: Registers; { stores the processor registers } 
begin 
Regs.ah := SOf; { function no. 15 = read the video mode } 
Intr($10, Regs); { call the BIOS video interrupt } 
if Regs.al=7 then { monochrome video card? } 
VioPtr := @MBuf { yes, set pointer to the monochrome video RAM } 
else { it's an EGA, VGA, or CGA card } 
VioPtr := @CBuf; { set pointer to color video RAM } 
end; 


{ BERR RE ERK EKEKEREKEKEKRKKRKEKEK ERK KEKE EER KEKE KEKEKKEK KK KEKEKEKRKEKEKEKEKKEKKEKKEKEE | 


{* SaveScreen: saves the screen contents in a buffer *} 
{* Input : SPTR : pointer to a buffer in which the screen contents *} 
{* will be saved my 
{* Output : none *} 


{ RR AAAAKRKKKKKREER EKER EKKERKKEKEKERK EEE KK EKKKEERKEKERKKEEREREREKEKKEKEKKKEKKEKEKE } 


procedure SaveScreen( SPtr : VPtr ); 


var line, { the current line } 
column : byte; { the current column } 

begin 
for line:=1 to 25 do { run through the 25 screen lines } 
for column:=1 to 80 do { run through the 80 screen columns } 


SPtr“[line, column] := VioPtr*[line, column]; { save ch.éattr. } 


end; 
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{BARRERA KER EERE EEE REEKEKKEKE EKER EERE EKEKKEEREKRERHEEKEKKEKREKKKEEKE | 
{* RestoreScreen: copies the contents of a buffer into the video RAM *} 


{* Input : BPTR : pointer to the buffer whose contents are to be *} 
{* copied into the video RAM =) 
{* Output : none *) 


[RARER RRR REE RRR REE RR RIKKI AERA RIERA ERE ERA REAR AKER EREERER | 


procedure RestoreScreen( BPtr : VPtr ); 


var line, { the current line } 
column : byte; { the current column } 
begin 
for line:=1 to 25 do { run through the 25 screen lines } 
for column:=1 to 80 do { run through the 80 screen columns 


VioPtr*(line, column] := BPtr“[{line, column]; { get ch. & attr. 
end; 


{BRR RR RR RHR RRR RI RIKER EIR KARIERRE REAR KKK ARERR KEKKK | 


{* ResPara: calculates the number of paragraphs which must be a) 
{* allocated for the program *} 
{* Input : none | 
{* Output : the number of pa.agraphs to be reserved a 


{RR RRR RIK RR IR IK RIK IK RII KR IRI KKK KIKI KIKI KIKI KAIRIE HKKR IK AIK HAIK KEE | 


function ResPara : word; 


begin 
ResPara := Seg (FreePtr“*) +$1000-PrefixSeg; { number of paragraphs } 
end; 


{AEA ARR EAHA ER EEK RRR R EK EERE R ERK KEKE KE KERR EERKREKKREKEREKEKKEKEKKEEES | 


{* EndProc: Called by the assembler module when the TSR program is *} 


{* reinstalled *) 
{* Input : none *} 
{* Output : none *} 
{* Info : This procedure must be in the main program and may not *} 
{* be turned into a FAR procedure by the $F+ compiler aS 
{* directive. *} 


{ BARRA RK RIK RHR IRE K RRR KR EK I KKK KHER AKAIKE K KAKA KE KEKE KE KKKKEKE | 


{SF-} { don't make a FAR procedure } 


procedure EndProc; 


begin 
Text Background( Black ); { dark background } 
TextColor( LightGray ); { light text } 


writeln('The TSR program was called ', ATimes, ‘ times.'); 
end; 


{HR RRR RRR I RIK KK RRR RIKER KKK KKK KEK KEKE KEKE KEE KEKRERERKKKKEKEKKKE | 


{* Tsr: This procedure is called by the assembler module after the ait 


{* hotkey is pressed. *} 
{* Input : none a 
{* Output : none *} 
{* Info : This procedure must be in the main program and may not *} 
1? be turned into a FAR procedure by the $F+ compiler *) 
{* directive. *} 


{ ARR RK RRR IRI RIKI RIK RARE IKARIA IAI IR ARIKIK AK AK AKER IK IKEKKAAKKK | 


{SF-} { don't make a FAR procedure } 


procedure Tsr; 


var BufPtr : VPtr; { stores pointer to the allocated blocks } 
Column, { the current screen column } 
Line : byte; { the current screen line } 


Key : char; 
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begin 

inc( ATimes ); { increment call counter } 
DispInit; { determine address of the video RAM } 
GetMem(BufPtr, SizeOf(VBuf) ); { allocate buffer } 
SaveScreen( BufPtr ); { save the screen contents } 
Line := WhereY; { get current screen line } 
Column := WhereX; { get current screen column } 
TextBackground( LightGray ); { light background } 
TextColor( Black ); { dark text } 
ClrScr; { clear the whole screen } 
GotoxXY (22, 12); 

write('TSRP - (c)} 1988 by MICHAEL TISCHER'); 


GotoXY (30, 14); 
write (‘Please press a key...'); 


Key := ReadKey; { walt for a key } 

RestoreScreen( BufPtr ); { copy the old screen contents back } 

FreeMem( BufPtr, SizeOf(VBuf) ); { release allocated buffer } 

GotoxXY( Column, Line ); { cursor back to original position } 
end; 


{RE RRKRHEHERH EKER KKK REE KKEEREKREEE KKK EE EKRKKEEKREREREKEKREKKEKEKEREEEEKKKEKEKE | 


{** MAIN PROGRAM a*] 


{ RRR K KERR KKK RK IER KR RK EKER IK KRERKEIKKIKKEREKKE EKER KEKEKEEEEEEKEKEE | 


begin 
writeln('TSRP - (c) 1988 by MICHAEL TISCHER'); 
IdString := 'TROTZKY'; 
if ( IsInst( IdString ) ) then { program already installed? } 
begin { YES } 
writeln('The TSR program now disabled.'); 
UnInst ( Ofs( EndProc ) ); { remove the program } 


{** if no end function is to be called, the call iss ******xkeKee 


** UnInst ( NO END FIN ); KKKKKRAKKKKE | 
end 
else { the program is not installed yet } 
begin ; 
ATimes := 0; { the program was not activated yet } 


writeln('TSR program now enabled. Start: <LSHIFT> + ', 
*<RSHIFT>') ; 
TsrInit ( Ofs(Tsr), LSHIFT or RSHIFT, ResPara, IdString ); 
end; 
end. 


Assembler listing: TSRPA.ASM 


FRA KKKERKE EKER ER EERE EKER ERRK KERR EKER KEKEK EKER KKEREKKREREKKEEKK © 


ok TSRPA *; 
ak Tc sess ct: Gis stu ses cuss is ai bn Cums" an em Gr came sb SS, er ui it svn hci SS ci us El es eso ui Ss me Sa igs lS ‘sso en Gu wes es oi cess Gh us Gm 3 
al Description : This is the assembler interface to a Turbo ¥> 
el Pascal 4.0 program which can be activated * 3 
: via a hotkey. La 
ss [es ein in ce ce Sos sec Sve Si is mms hes ess ems ei nib eins mh au imc cs ce tims te sesh wis cs ere Sous nas ce aes tee eo Sas (Gime Gms ene an sb tu es mm es ei Sem cms wr ce Sm sw as 
7s Author : MICHAEL TISCHER id 
7* developed on : 08/12/1988 ¥e 
;* last update : 08/18/1988 ws 
Paces eee esas cis es fs ces mesh ce ms sacs ‘cans mss le inc ccm Us es ss ins ms cin us is es co tam Sm mcs Ges ats esas se ts ens macs ts cei ts cs taco cea ams “as as cnc ems tas ep nos cohen es cs as ao xe 
gs v 
ad Info : The module must be in a program and may not *s 
= be bound into a UNIT. = 
0 IG a sais es is ia ts a ca tans ce istics es cis es cease ns aca Wiss Sos cas as ces ssh us wesc tetas an Sk ees teleosts "Ses Cease Se te ee Uwuon Ssh ems ces chen sis ih snobs gs Mn wlan cas Ga en Cer Sie toi dvs wi ne ke 
gv A 
oe to assemble : MASM TSRPA; “>; 
ris -«. combine with a Turbo Pascal program * 
FREAK EKER KEKE REREEEKE EKER EERE REKAEEKEKEEKRKEEREREEERKEERKKEKEKREKEKEEEKE 8 


DATA segment word public 7Turbo data segment 


DATA ends zend of the data segment 
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MAX_ID LEN equ 16 ;maximum length of the ID string 
7== Program ==Sss=sssenansssssesSs a rsss es SSE SSS SSE SSS SSeS SS SSS SSS 
CODE segment byte public sthe Turbo code segment 

assume cS:CODE, ds:DATA, es:CODE 


;-- Public declarations of internal functions ----------~---------------- 


public tsrinit sallows access by the Turbo program 
public isinst 

public uninst 

;~-~ Variables for the interrupt handler -----------~-------------------- 
z-- (accessible only via the code segment ------------------------------ 
id_buf db (MAX ID LEN + 1) dup (0) ;buffer for the ID string 

ce ptr equ this dword ;points to the routine CALL END in the 
ce ofs dw offset call end ;already-installed TSR program 

ce_ seg dw ? 


7-~- Variables neded for activation of the Turbo program ~-------------- 


t_ss dw 0 ;Turbo stack segment 

t_sp dw 0 7Turbo stack pointer 

t_ds dw 0 ;Turbo data segment 

t_es dw 0 ;Turbo extra segment 

t_dta ofs dw 0 ;DTA address of the Turbo program 
t_dta_seg dw 0 

t_psp dw 0 ;seg addr of the PSP of the Turbo prg. 
pre_adr dw 0 jaddress of the Turbo TSR procedure 


7-~ Variables for testing for the hotkey -~--~---~---------------------- 


key_mask dw 0 ;hotkey mask for BIOS keyboard flag 

recur db 0 7prevents recursive TSR calls 

in bios db 0 ;shows activity of the BIOS disk 
zinterrupt 

daptr equ this dword zpointer to the DOS INDOS flag 

daptr ofs dw 0 ;offset address 

daptr seg dw 0 ;segment address 


7-- The following variables store the old addresses of the interrupt --- 
z-- handlers which will be replaced by new interrupt handlers ieee 


int9 ptr equ this dword 7old interrupt vector 9h 

int9 ofs dw 0 ;offset address of the old handler 
int9 seg dw 0 ;segment address of the old handler 
intl3 ptr equ this dword 7Oold interrupt vector 13h 

intl3 ofs dw 0 ;offset address of the old handler 
intl3_ seg dw 0 z;segment address of the old handler 
int28 ptr equ this dword ;old interrupt handler 28h 

int28 ofs dw 0 ;offset address of the old handler 
int28 seg dw 0 ;segment address of the old handler 


;-- Variables for storing information about the interrupted ------------ 
P7~ PYOGTAM a a a 


u_dta ofs dw 0 ;DTA address of interrupted program 
u_dta_seg dw 0 


u_psp dw 0 7seg addr of the PSP of the int. prg. 
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uprg ss dw 0 7SS and SP of the interrupted prg. 
uprg_sp dw 0 


~- TSRINIT: ends the Turbo program and activates the new interrupt ---- 


; 
; 
i-- handler 
7-- Call from Turbo: procedure TsriInit( PrzPtr : word; 
j-- KeyMask : word; 
j-- ResPara : word; 
j-- IdString : string[16] ); 
tsrinit proc near 
sframe0 struc ;structure for accessing the stack 
bpd dw ? 7;stores BP 
ret_adrO dw ? ;return address 
idptr0 dd ? ;pointer to the ID string 
respara0 dw ? snumber of paragraphs to be reserved 
keymask0 dw ? ;mask for hotkey 
prcpt rd dw ? ;pointer to the Turbo TSR procedure 
sframe0 ends 7end of the structure 
frame equ [ bp - bpd ] 
push bp 7Ssave BP on the stack 
mov bp,sp ymove SP to BP 
push es ;save ES on the stack 
;-- Save the Turbo segment registers --------<----<--<-<-<----<--- 
mov cs;:t_ss,ss ;save the registers in the appropriate 
mov cs:t_sp,sp ;variables 


mov cs:t_es,es 
mov cs:t_ds,ds 


7-- copy the ID string into the internal buffer ------------- 


push ds zsave DS on the stack 

lds si, frame. idptr0 7;DS:SI now points to the string 
push cs 7put CS on the stack 

pop es jand restore as ES 

mov di,offset id buf ;ES:DI now points to ID_BUF 

xor ch,ch ;Clear high byte of the counter 
mov cl, [si] ;get length of the string 

inc. cl 7copy the length byte too 

rep movsb ;Ccopy the entire string 

pop ds 7restore DS 


z;-- determine PSP of the Turbo program ---------------~------- 


mov bx,cs ;transfer CS to BX 

sub bx,10h 710h paragraphs = subtract 256 bytes 
mov cs:t_psp, bx ;Save segment address 

;—-~ Save the parameters passed ------------------------------ 


mov ax,frame.prcptrO ;get pointer to the TSR procedure 


mov cs:prc_adr,ax ;and save 
mov ax,frame.keymask0O ;get mask for the hotkey 
mov cs:key mask, ax 7and save 


7~- determine DTA address of the Turbo program ----~---------- 
mov ah,2fh ;ftn. no.: get DTA address 

int 2ih 7call DOS interrupt 

mov cs:t_dta ofs,bx ;store address in the appropriate 

mov cs:t_dta_seg,es ;variables 


7~~ determine the address of the INDOS flag ----------------- 
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sftn. no.: get adr of the INDOS flag 
7call DOS interrupt 

;save address in the appropriate 
svariables 


z-- get the addresses of the interrupt handlers to change --- 


push 
MOV 
mov 


MOV 
mov 
int 


mov 
mov 
int 


mov 
mov 
int 


tA 


mov 
mOV 
int 


tsrinit endp 


ax, 3509h 

21h 

cs:int9 ofs, bx 
cs:int9 seg,es 


ax,3513h 

21h 

cs:int13 ofs,bx 
cs:int13_seg,es 


ax, 3528h 

21h 

cs:int28 ofs,bx 
cs:int28 seg,es 


sget interrupt vector 9h 

;call DOS interrupt 

ssave address of the handler in the 
jappropriate variables 


;get interrupt vector 13h 

scall DOS interrupt 

zsave address of the handler in the 
;appropriate variables 


7get interrupt vector 28h 

7call DOS interrupt 

ssave addres of the handler in the 
;appropriate variables 


install the new interupt handlers ----------------------- 


ds 
ax, cs 
ds, ax 


ax, 2509h 
dx,offset int09 
21h 


ax, 2513h 
dx,offset int13 
21h 


ax, 2528h 
dx, offset int28 
21h 


ds 


7;save data segment 
7CS to AX and then load into DS 


;ftn. no.: set interrupt 9h 
7;DS:DX stores the addr of the handler 
;call DOS interrupt 


;ftn. no.: set interrupt 13h 
;DS:DX stores the addr of the handler 
zcall DOS interrupt 


sftn. no.: set interrupt 28h 
sDS:DX stores the addr of the handler 
7call DOS interrupt 


;get DS back from the stack 


End resident program <------------ nn 


ax, 3100h 


dx, frame. respara0 


2ih 


;ftn. no.: end resident program 
7get number of reserved paragraphs 
;call DOS interrupt and thus end 
;the program 


7-- ISINST: Determines if the program is already installed --~---------- 
;-- Call from Turbo: function IsInst( IdString : IdsType }) : boolean; 


sframel 


frame 


proc 


stru 
dw ? 
dw ? 
dd ? 
ends 


equ 
push 


MOV 
push 


else 0°: 
near 


Cc 


[ bp - bpl ] 


bp 
bp, sp 
ds 


tf 
7-- Return value: 1, if the program was already installed, 
; 


sstructure for accessing the stack 
;stores BP 

;return address 

;pointer to the ID string 

zend of the structure 


;save BP on the stack 
;transfer Sp to BP 
;save DS on the stack 
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;-- determine segment address of the current int 9 handler -- 


mov ax,3509h ;get interrupt vbector 9h 

int 21h ;DOS interrupt gets seg addr in ES 
mov di,offset id buf ;ES:DI points to the installed ID BUF 
lds si,frame.idptri 7DS:SI points to the ID STRING passed 


xor dl,dl zreturn code: not installed 
mov cl, [si] ;get length of the string 
mov. ch,dl shigh byte of the counter to 0 
isid: lodsb jload character from string 
emp al,es:{di] ;compare with other string 
jne not_inst snot equal --> NOT_INST 
inc di zincrement pointer to string 2 
loop isid 7compare the next characters 
mov dl,l ;the strings are identical 
not_inst: mov al,dl fput return code in AL 
pop ds 7get DS back from stack 
pop bp get BP back from stack 
ret 4 7back to the caller 
isinst endp ;end of the procedure 


77~ CALL END: calls the end function when the TSR is reinstalled ------- 
77~- Input : DI = offset address of the routine to be called 

j-- Info : This function is not intended to be called by a Turbo 

;-- program 


call_end_ proc far 


call di 7call the end function 
ret zback to the caller 


call end endp 


a ee ee ee ee ca ene Se Oe ee ne Se Oe cae Oe Se SE nem GD SD NE SO me ee ate Meee HONS I DD NP SED ey SD OU SOS ED Ss MN SEED wad aN GEE ED tS ERE ED aD ene RAD NEY Ge nn CO SRO ME SN AE SE SP ens ster OY SE ee we 


f 
-- UNINST: removes the TSR program and releases the allocated --------- 


7 
i memory. 
77~- Call from Turbo : procedure UnInst( EndPtr : word ); external; 
7-- Info : If the value SFFFF is passed as the address, 
77 . then no end function will be called. 
z-- Note : This function should be called only if a previous 
i-- call to IS INST() returned a value of 1. 
uninst proc near 
sframe2 struc ;structure for accessing the stack 
bp2 dw ? ;stores BP 
ret_adr2 dw ? ;return address 
preptr2 dw ? ;pointer to the end procedure 
sframe2 ends zend of the structure 
frame equ [ bp —- bp2 ] 

push bp ;save BP on the stack 

mov bp,sp stransfer SP to BP 

push ds ;save DS on the stack 


7~- determine seg addr of the current int 9h handler --- 


mov ax, 3509h 7get interrupt vector 9h 

int 21h 7DOS interrupt puts seg addr in ES 
mov di,frame.prcptr2 ;get address of the end procedure 
emp di,Offffh 7no end procedure called? 

je  no_endpre 7NO ---> NO_ENDPRC 
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no endprc: 


;-~- Perform context change to the Turbo program and 
;-- execute the specified end procedure 


mov 


mov 
mov 


cli 
mov 
mov 


push 
mov 
int 
mov 
mov 


pop 


mov 
mov 
int 


push 
push 


mov 
mov 
mov 
int 


mov 
mov 


call 


cs.ce seg,es 


cs:uprg ss,ss 
cs:uprg sp,sp 


ss,es:t_ss 
sp,es:t_sp 


es 

ah, 2fh 

21h 

cs:u_dta_ ofs,bx 
cs:u_dta_ seg,es 
es 


ah, 50h 
bx,es:t_psp 
21h 


ds 
es 


ah, lah 
dx,es:t_dta ofs 
ds,es:t_dta_ seg 
21h 


ds,es:t_ds 
es,es:t_es 


cs: [ce ptr] 


context change to the Turbo program 


ah, lah 
dx,cs:u_dta ofs 
ds,cs:u_dta_ seg 
21h 


es 
ds 


ah, 50h 
bx, cS 
bx, 10h 
21h 


Ss,cS:uprg ss 
sp,csS:uprg_ sp 


reinstall the interrupt handler of the TSR 


; program again 


ax, 2509h 
ds,es:int9 seg 
dx,es:int9 ofs 
21h 


ax, 2513h 
ds,es:int13 seg 
dx,es:int13_ ofs 
21h 


;save ES in the jump vector 


;save current stack segment and stack 
;pointer 


;disable interrupts 
yactivate the stack of the TSR 
;program 


ssave ES on the stack 

;ftn. no.: get DTA address 

7call DOS interrupt 

;save DTA address of the interrupted 
; program 

7get ES from the stack 


;ftn. no.: set address of the PSP 
;get segment address of the PSP 
;call DOS interrupt 


;save ES and DS on the stack 


;ftn. no.: set DTA address 

;get offset address and segment 
jaddress of the new DTA 

;call DOS interrupt 


;set segment register for the Turbo 
;program 


7call the end procedure 


;ftn. no.: set DTA address 

;load offset and segment addresses 

7of the DTA of the interrupted program 
zcall DOS interrupt 


;yrestore seg addr of the Turbo program 
7from the stack 


;ftn. no.: set address of the PSP 
;put CS in BX 

;calculate segment address of the PSP 
;call DOS interrupt 


;disable interrupts 

;restore stack pointer and stack 
7; segment 

;allow interrupts again 


;disable interrupts 

;ftn. no.: set handler for int 9 
;segment address of the old handler 
;offset address of the old handler 
;reinstall the old handler 


;ftn. no.: set handler for int 13 
;segment address of the old handler 
;offset address of the old handler 
sreinstall the old handler 
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mov ax,2528h ;ftn. no. set handler for int 28 
mov ds,es:int28 seg ;segment address of the old handler 
mov dx,es:int28 ofs poffset address of the old handler 
int 21h ;reinstall the old handler 
sti zallow interrupts again 
mov es,es:t_psp ;save seg addr of the PSP of the 
mov cx,esS ;Turbo program in CX 
mov es,es:[{ O2ch } zget seg addr of environ from PSP 
mov ah,49h 7ftn. no.: release allocated memory 
int 2ih ;call DOS interrupt 
mov es,cx 7restore ES from CX 
mov ah,49h ;ftn. no.: release allocated memory 
int 21h 7call DOS interrupt 
pop ds ;restore DS and BP from stack 
pop bp 
ret 2 ;return to the caller 

uninst endp rend of the procedure 


z7—- the new interrupt 09h handler ~-------~----------------=------------- 
into9 proc far 


pushf 
call cs:int9 ptr 


7simulate calling the handler via the 
7INT 9h instruction 


eli ;suppress interrupts 

cmp cs:recur,0 zis the TSR program already active? 
jne ik_end 7Yes, back to the caller of int 9 
7-- test to see if the BIOS disk int is being executed 


cmp cs:in_ bios,0 
jne ik_end 


7;BIOS disk interrupt active? 
7YES --> abck to caller 


;-~- BIOS disk interrupt is not active, test for hotkey ----- 


push ax z;save ES and AX on the stack 

push es 

xor ax, ax ;set ES to the lowest memory segment 
mov eS,ax 

mov ax,word ptr es:[417h] ;get BIOS keyboard flag 


and ax,cs:key mask 7mask out the non-hotkey bits 

cmp ax,cs:key mask yare only the hotkey bits left? 
pop es ;restore ES and AX 

pop ax 

jne ik_end shotkey discovered? NO --> return 


7~- the hotkey was pressed, test to see if DOS is active --- 


push ds 
push bx 
lds bx, cs:daptr 


7save DS and BX on the stack 


7DS:BX now point to the INDOS flag 


cmp byte ptr [{bx],0 ;DOS function active? 

pop bx get BX and DS from the stack 
pop ds 

jne ik_end ;DOS function active --> IK_END 


7-- DOS is not active, activate TSR program ---------------- 
call start tsr ;Start the TSR program 
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ik_end: iret sback to the interrupted program 
int09 endp 
7-~ the new interrupt 13h handler -----------------~ 3+ rn 
int13 proc far 
mov cs:in bios,1 ;set flag and show that the BIOS disk 
sinterrupt is active 
pushf ;simulate calling the old interrupt 
call cs:int13_ ptr rhandler via int 13h 
mov cs:in bios, 0 ;BIOS disk interrupt no longer active 
ret 2 zback to the caller, but don't get 
sthe flag reg from the stack first 
int13 endp 


7-- the new interrupt 28h handler -~----------- ne enn 


int28 proc far 
pushf ;simulate calling the old interrupt 
call cs:int28 ptr vhandler via int 28h 
cli ;suppress further interrupts 
cmp cs:recur,0 zis the TSR program already active? 
je idOdl 7NO ---> IDO1 
id_end: iret 7YES -—--> back to the caller 
z-- the TSR program is not yet active --------------------- 
idOQl: cmp cs:in bios, 0 zis BIOS disk interrupt active? 
jne id_end 7YES --> back to the caller 
;-- BIOS disk interrupt not active, test for hotkey ------- 
push ax ;save ES and AX on the stack 
push es 
xOor ax, ax ;set ES to the lowest memory segment 
MoV eS,ax 
mov ax,word ptr es:[417h] ;get BIOS keyboard flag 
and ax,cs:key mask ;mask out the non-hotkey bits 
cmp ax,cs:key mask yare only the hotkey bits left? 
pop es ;restore ES and AX 
pop ax 
jne ik_end shotkey discovered? NO --> return 
call start _tsr 7;start the TSR program 
iret ;back to the interrupted program 
int28 endp 
;-~ START TSR: activate the TSR program ~—-----------<----- 9 


Start tsr proc near 


mov cs:recur,1 ;set the TSR recursion flag 


;-- perform context change to the TSR program -------~------~ 


mov cS:uprg SS,Ss ;save current stack segment and 

mov csS:uprg sp,sp ;stack pointer 

mov ss,cs:t_ss yactivate the stack of the 

mov sp,cs:t_sp ;Turbo program 

push ax ;save the processor registers on the 
push bx ;turbo stack 

push cx 
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tsrsl: 


tsrs2: 


push 
push 
push 
push 
push 
push 


dx 
bp 
si 
di 
ds 
es 


save 64 words from the DOS stack ~---<------------------- 


cx, 64 
ds,cs:uprg_ss 
si,cs:uprg_ sp 


push word ptr [si] 


inc si. 

inc si 

loop tsrsl 

mov ah,5lh 

int 21h 

mov csS:u_psp,bx 
mov ah,2fh 

int 21h 

mov cs:u_dta ofs,bx 
mov cs:u_dta_ seg,es 
mov ah,50h 

mov bx,cs:t_psp 

int 21h 

mov ah,lah 

Mov dx,cs:t_dta ofs 
mov ds,cs:t_dta_ seg 
int 21h 

mov ds,cs:t_ds 

mov eS,cs:t_es 

sti 

call cs:pre adr 

cli 


_gloop counter 


sset DS:SI to the end of the DOS stack 


;save word from the DOS stack on the 


_ 7 stack and set SI to the next word 


;process all 64 words 


;ftn. no.: get addr of the PSP 
7call DOS interrupt 
;save seg addr of the PSP 


7ftn. no.: get DTA address 
zcall DOS interrupt 

;save address of the DTA of the 
;interrupted program 


;ftn. no.: set address of the PSP 
;get seg addr of the Turbo prg PSP 
;call DOS interrupt 


;ftn. no.: set DTA address 

;get offset address of the new DTA 
;and segment address of the new DTA 
;call DOS interrupt 


;set segment register for the 
;Turbo program 


yallow interrupts again 


scall the start function 
;disable interrupts 


;-- perform context change to the interrupted program ------ 


ah, lah 


dx,cs:u_dta ofs 
ds,cs:u_dta_seg 


21h 


ah, 50h 
bx, CS:u_psp 
21h 


;ftn. no.: set DTA address 

;load offset and segment addresses 
;of the interrupted program's DTA 
7call DOS interrupt 


;ftn. no.: set address of the PSP 
zseg addr of the interrupted prg's PSP 
;call DOS interrupt 


restore DOS stack again -------------3 993 nnn nn 


cx, 64 
ds,cS:uprg_ ss 
si, cs:uprg_sp 
si,128 

si 

si 

word ptr [si] 
tsrs2 


es 
ds 
di 
si 


zloop counter 

zload DS:SI with the end address of 
;the DOS stack 

;set SI to the start of the DOS stack 
7Si to the previous stack word 


;words from Turbo stack to DOS stack 
;process all 64 words 


srestore the saved registers from the 
;Turbo stack 
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pop bp 

pop dx 

pop Cx 

pop bx 

pop ax 

mov ssS,cs:uprg ss zset stack pointer and segment 
mov sp,cs:uprg sp ;of the interrupted program 
mov csS:recur,0 ;resset TSR recursion flag 
ret zback to the caller 


start tsr endp 


CODE ends send of the code segment 
end vend of the program 
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Chapter 9 


Sound on the PC 


Every PC has a built in speaker which beeps when some errors occur, or when the 
keyboard buffer is full. The speaker can also generate other sounds. This chapter 
demonstrates sound generation through software. 


How the PC generates sound 


Tones occur when the cone of a speaker oscillates (moves back and forth). A single 
oscillation creates a click instead of a musical sound. If a group of oscillations 
sounds in rapid succession, a tone occurs. The pitch (the note value) of a tone 
depends on the number of cycles (oscillations) that occur per second. The pitch of a 
tone in cycles per second is measured in Hertz. For example, if the speaker 
oscillates at a rate of 440 times per second, it generates a tone with a frequency of 
440 Hertz. Certain pitches have specific note names assigned to them, such as 
A440 (the note that sounds at 440 Hertz). The following table shows the pitches 
and frequencies of tones generated by the PC. This range covers 8 octaves (almost 
the range of a full piano keyboard): 


CC A SE SS RN OE LE: SO 


|B | 30.87} B | 61.74] Bf 123.47] Bf 246.94 | 
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lOctave fT 


| D_ | 293.66] D_ | 587.33] D [1174.66] D [2349.32 | 
| p# | 311.13] p# | 622.25] p# [1244.51 
| = | 329.63] E | 659.26] E |1328.51] E  |2637.02 
1567.98 
1661.22 
| A_| 440.00] A_ | 880.00] A_|1760.00] A _|3520.00_ 
| At | 466.16] A# | 923.33] A¥ |1864.66] A# [3729.31 | 
| B | 493.88] B_ | 987.77] B {1975.53} B [3951.07 | 


The speaker in the PC can generate frequencies from 1 Hertz up to more than 
1,000,000 Hertz. However, most human ears are only capable of hearing 
frequencies between 20 and 20,000 Hertz. In addition, PC speakers don't reproduce 
music very well since they play some tones louder than others. Since the speaker 
has no volume control, this effect cannot be changed. 


A sound program should oscillate the speaker according to the frequency of the 
tones desired. Here is a rough outline of a possible sound generation program: 


° Invoke the instruction to move the cone forward, then undo the instruc- 
tion (move the cone back to its original position). Repeat these steps ina 
loop so that it occurs as many times per second as required by the 
frequency of the tone being generated. 


The above procedure has several disadvantages: 


° The execution speed of individual instructions depends on the processing 
speed of the computer. 

. This program must be adjusted to the processing speed of individual 
computers. 

° The tone becomes distorted when the tone production loop ends. 


8253 timer 
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Every PC uses one particular chip for tone generation: The 8253 programmable 
timer, which actually maintains control of the internal clock. The 8253 can 
perform both timing and sound thanks to its ability to enable a certain action at a 
Certain point in time. It senses timing from oscillations it receives from the PC's 
8284 oscillator, which generates 1,193,180 impulses per second. The 8253 can 
then be instructed how many of these impulses it should wait before triggering a 
certain action. In the case of tone generation, this action consists of sending an 
impulse to the speaker. Before executing this action, the chip must be programmed 
for the particular frequency it should generate. The frequency must be converted 
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from cycles per second into the number of oscillations coming from the oscillator. 
This is done with the help of the following formula: 


counter = 1,193,180 / frequency 


The result of this formula, the variable counter, passes to the chip. As the formula 
demonstrates, the result for a high frequency is relatively low, and the result for a 
low frequency is relatively high. This makes sense, since it tells the 8253 chip 
how many of the 1,193,180 cycles per second it must wait until it can send 
another signal to the speaker. The lower the value, the more often it sends a signal 
to move the speaker cone back and forth, causing a higher tone. 


Ports and PC sound 


Communication between the CPU and the 8253 occurs through ports. First the 
value 182 is sent to port 43H. This instructs the 8253 that it should start 
generating a signal as soon as the interval between individual signals has been 
passed. This interval is the value which was calculated with the formula above. 
Since the 8253 stores this value internally as a 16-bit number (a value between 0 
and 65,535), it limits the range of tones generated to frequencies between 18 and 
1,193,180 Hertz. This number must be transmitted to port 42H. Since this is an 
8-bit port, the 16 bits of this number cannot be transmitted simultaneously. First 
the least significant eight bits are transmitted, then the most significant eight bits 
are transmitted. 


Now the second step occurs—the 8253 signal is sent to the speaker. The speaker 
access occurs through port 61H, which is connected to a programmable peripheral 
chip. The two lowest bits of this port must be set to 1 to transmit the 8253 signal 
to the speaker. Since the remaining six bits are used for other purposes, they 
cannot be changed. For this reason, the contents of port 61H must be read, the 
lowest two bits must be set to 1 (an OR combination with 3) and the resulting 
value must be returned to port 61H. A tone sounds, which ends only when the bits 
just set to 1 are reset again to 0. 
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Octave 3 Octave 4 Octave 5 


C# Dt Ft GH At C# D F% GtA C#D Fe Gt At 


C D E F G A B C D E F G A B C D E F G A B 
C 9121 F#= 6449 C = 4560 F#= 3224 C = 2280 F#= 1612 
C#= 8609 G = 6087 C#= 4304 G = 3043 C#= 2152 G = 1521 
D = 8126 G#= 5746 D = 4063 G#= 2873 D = 2031 G#= 1436 
D#= 7670 A = 5423. p#= 3834 A = 2711 D#= 1917 A = 1355 


5119 E = 3619 A#= 2559 E = 1809 A#= 1292 
6833 B = 4831 F = 3416 B = 2415 F = 1715 B = 1207 


3) 
| 
~ 
N 
WwW 
\o 
YD 
a 
i 


Keyboard setup and timer frequencies 


Demonstration programs 


GW-BASIC and Turbo Pascal have resident sound commands. The machine 
language programmer and C programmer must create their own sound applications. 


Demonstration programs follow for both these languages. They can be added to 
your own C or assembly language programs. 


How they work 
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Both programs produce tones for specific time periods. This is done with the help 
of the timer interrupt 1CH which is called by the timer interrupt 8H 18.2 times 
per second. When the tone generation routine executes, it receives the frequency of 
the tone and the tone's duration (length). The duration is measured in 18ths of a 
second, so the value 18 corresponds to a second and the value 9 corresponds to a 
half-second. This value is stored in a variable. 


Immediately before activating the tone output, the interrupt routine of interrupt 
1CH turns to a user-defined routine. This routine, called 18.2 times per second, 
decrements the tone duration in the variable during every call. When it reaches the 
value, the tone duration ends and the tone must be switched off. The routine 
allocates a variable to notify the actual sound routine of this end. The sound 
routine recognizes this immediately, since it has been in a constant wait loop since 
Switching on the tone. Ail this loop does is monitor the contents of this variable. 
After recognizing the end of the tone, it stops the sound output and returns the 
timer interrupt to its old routine. 
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The sound routine requires the number assigned to this tone, rather than the 
frequency itself. This number is related to the table containing the frequencies of 
octaves 3 to 5. The value 0 stands for C of the third octave, 1 stands for C-sharp, 2 
for D, 3 for D-sharp, etc. 


Note: Both the C program and assembly language program demonstrate the 
sound routine by playing a scale over the course of two octaves, with 
each note sounding for a half a second each. The machine language 
demo program and sound routine are stored in one file. The C 
versions of these programs are split into two source code files. The C 
demo program contains the sound function call only, and the machine 
language program which creates the sound must be linked to the 
demonstration program. 


Assembler listing; SOUNDA.ASM 


PRR R KKK KERRIER KKK IKE KERR KKK HEK KEK REE RE KIER ERK KKK EKER ERE KEE KEEKKKEK KK 8 


v 
a SOUNDA = 
e* ah ao si eer Svinte ss an Soph Gps enschede ns cas is Cen Was ec aT sims ts ist e's me's meni eu eet ih ba eu ies sis *s 
om Task : Plays a scale between octaves 3 and 5 of the ms 
ce PC's musical range. This routine can be used ba 
an for other applications sat 
o* ei i: it ml iS Si li SSeS i ii! cs. ene seh sees i nt ee Sum es ns cin i ei i ee sei incl ng i fi Si ii sie mii gh i. i ie msi we 
as Author : MICHAEL TISCHER * 
zt Developed on : 08/06/1987 xe 
5% Last update : 05/26/89 es 
as ei i: cn ea ii an ins in ec ia i sist gh Sm lr ek ni Spe ncn ina ci wi me a wa i imi se ms ein lm fe wl i ere Sl wai le se oi il id lel i a ws 
7* Assembly : MASM SOUNDA; *s 
;* LINK SOUNDA; ts 
EXE2BIN SOUNDA SOUNDA. COM *F 
7s ci rss mc si wae nai Sp Ss i Ses eu em Sates tas ign ‘ssa lus tin e's nis cS seus sms Wn snc coms Sin eis wine Gos Sls mise ‘sos ew Sms cose ‘Sem ees cams ‘Se Sein ‘ue ss "Gea se es ‘ts ck tess, ue 
as Call from DOS : SOUNDA oe 
FREER KEKE EERE KEKE KKK KKK ERK KER KEKE KEKE KEKE KEKE KKKEKREKREKREEKKKEKKER 8 


g 
code segment para '‘CODE' 7Definition of CODE segments 


org 100h 7;Starts at address 100H 
;directly following PSP 


assume cs:code, ds:code, es:code, ss:code 


sound proc near 
;-- Display me@SSAaQe@ ----3—- ee nr rn rn rere 
mov ah,9 ;Function number for displaying string 
mov dx,offset initm ;String's offset address 
int 21h 7Call DOS interrupt 21H 
@7— Play SCal@ --n ween nen nn rn rr rrr rr rn 
xor bl,bl ;Start at C of octave 3 
mov dl,9 ;for duration of 1/2 second 

nextune:; call play tune 7Play note 
inc bl ;Next note 
cmp bl1,36 7;All notes in this octave played? 
jne nextune 7NO --> Play next note 
7-- Display end message —------~- 2-99 nn rn 
mov ah,9 ;Function number for string display 
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mov adx,offset endmes 
int 2ih 


7String's offset address 
;Call DOS interrupt 21H 


mov ax,4C00h ;Program ends when call to a DOS 


int 21h sfunction results in an error code 
;of 0 

sound endp 

initm db 13,10,*SOUND (c) 1987 by Michael Tischer",13,10,13,10 
db “Your PC should now be playing a chromatic scale in the" 
db "3rd and 5th *,13,10,“octaves of its range, if * 
db “your PC speaker works.",13,10,"$" 

endmes db 13,10,*End",13,10,"$" 

s=>° PLAY TUNES Play @ i NOCG @—=—==—=]===—S— 666 $355 see e ee = 

z-- Input : BL = Note number (relative to C of the 3rd octave) 

i-- DL = Duration of note in 1/18 second increments 

7-- Output : none 

7-~- Register : AX, CX, ES and FLAGS are changed 

7-- Info : Immediately after the tones, control returns to the 

; 


play tune proc 


push 
push 


calling routine 


near 


dx 
bx 


;Push DX and BX onto the stack 


;-- Adapt timer interrupt to user program --------------------- 


push dx ;Push DX and BX onto stack 
push bx 
mov ax,35lich 7Get address of time interrupt 
int 2ih ;Call DOS interrupt 
mov old time, bx ;Offset address of old interrupt 
mov old time+2,es z;and note segment address 
mov dx,offset sound ti ;Offset address of new timer routine 
mov ax, 25lch 7;Set new timer routine 
int 2ih 7Call DOS interrupt 
pop bx 7Pop BX and DX off of stack 
pop dx 
mov al1,182 7;Prepare to play note 
out 43h,al ;Send value to time command register 
xor bh,bh 7BH for addressing note table = 0 
shl bx,1 7;Double note number (fr. word table) 
mov ax, [notetbx] 7Get tone value 
out 42h,al 7;LO-byte on timer counter register 
mov al,ah 7Transfer HI-byte to AL 
out 42h,al zand to timer counter register 
in al, 61h ;Read speaker control bit 
or al,lib ;Lowest two bits enable speaker 
mov s_ende,1 ;Note still has to be played 
mov s_counter,dl 7Play note for duration 
out 61h,al 7;Disable speaker 
play: cmp s_ende,0 7;Note finished? 
jne play 37N) --—> Wait 
in al,6lh ;Read speaker control bit 
and al,11111100b 7Clear lowest two bits 
out 61h,al ;Disable speaker 


Reactivate old timer interrup 


cx, ds 


mov ax,25lch 


7Note DS 
7;Set function no. for intrrpt vector 
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lds dx,dword ptr old time ;Load old address into DS:Dx 


int 21h 7Call DOS interrupt 

mov ds, cx 7Return DS 

pop bx 7;Pop BX and DX off of stack 
pop dx 

ret ;Return to calling program 


play tune endp 


7—-~ new timer interrupt —--— nem en nn rr rrr rr rrr nnn 
sound ti proc far :Call 18 times per second 

dec cs:s_ counter 7Decrement counter 

jne st_ende z;If still >0, end 

mov cs:s_ende,0 7Signal note end 


st_ende: jmp dword ptr cs:{old time] ;Goto old timer interrupt 


sound ti endp 


7== Variable set needed by the routines =========s==s=sses=ses=em=e====E==== 

old time dw (?), (?) ;Address of old timer interrupt 

s counter db (?) zcounter for note duration in 1/18 
;second increments 

Ss ende db (?) ;Displays whether note already played 

note dw 9121,8609,8126,7670 ;Note values for octave 3 


dw 7239, 6833, 6449, 6087 
dw 5746,5423,5119, 4831 
dw 4560, 4304, 4063,3834 ;Note values for octave 4 
dw 3619, 3416, 3224, 3043 
dw 2873, 2711, 2559, 2415 
dw 2280, 2152,2031,1917 ;Note values for octave 5 
dw 1809,1715,1612,1521 
Qw 1436,1355,1292,1207 


code ends 7End of CODE segment 
end sound 7End of the Assembler-Program 


Here's the C program to call the sound function and the assembly language listing 
of the C sound function. 


C listing: SOUNDC.C 


[ RERRAEKHRKKKEKKKKEERKKKEKE KERR AKEKKEKREKEKEKKEKEKKEEKKEKK RKKKKKKEKKKEKKKKKKKKKKK / 


/* SOUNDC */ 
/* co cee am ins es cs ee ss cam ub ce ee eae SD Gh cm a ue SER SS UD CED UD eset Gite is ce Sm GD DS ENE ND GAP HUD GUD OUND A AS a aD CES COD ED DD SD Sb GUD OU Dom se > xf 
f* Task : Plays a scale between octaves 3 and 5 of the */ 
£* PC musical range, using an assembler function */ 
/* Se crm sis in anh ne SW nS A ND EN EN i in ORS SP SSD ENS UD MD‘ im Sun i Dh a EES Gf SI SSE Gis ND GS SOU CGD UE Sh SD GED CED ED CRD acs xf 
/* Author : MICHAEL TISCHER *}- 
L* Developed on : 08/15/1987 ait A 
J* Last update : 05/26/1989 tf 
/* in a ie indi ce iin Sa mS ns mem Sow cr ses a Ss es us i tr i Cm cm mab nner ee cr is ce em mn min em, ims ms ao em cam ei sh a a rs a cas xf 
/* (MICROSOFT C) */ 
hes Creat ion : CL /AS SOUNDC.C */ 
/* LINK SOUNDC SOUNDCA; */ 
/* ~~ Call : SOUNDC */ 
/* Sc re cc eine mp cv en ens em Gm eS i ns a neu NG EE Se tn mm em i Nn Dc a in FE em Ds See END ent tn em em i cin ns xf 
/* (BORLAND TURBO C) */ 
/* Creation : Create a project file listing the following: Ff 
/* soundc wy: 
/* soundca obj at 4 
7% Options : Before compiling and linking, select the */ 
[* Options menu and Linker option. Under the uy 6 
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f* Linker options menu, make sure that the */ 
/* Case sensitive link option is set to Off *7 


[ RRKRRRIRKREI EKER KERIKERI AEE KEKE KKEEKREEKERERERKEEEKEKEEEEEKKEKKE / 


/*== Function declaration from the assembler module =====#===s==«==2======t/ 


extern void Sound ()?; /* Add the external assembler routine */ 


[RRR EEK REE KEIR IKI IIK IRE KEKE KKK AKER REKERKEEKEREKEKKKKK | 


[en MAIN PROGRAM ial 


[RRA KERIKERI IKEA AEE EREKEKEEKKKS | 


void main () 


{ 
int Note; 


printf("\nSOUND (c) 1987 by Michael Tischer\n\n") ; 

printf ("Your PC should now be playing a musical scale in the 3rd & "); 
printf(" Sth octaves of\nits range. If you aren't hearing the notes"); 
printf(" your PC's speaker may be damaged.\n\n") ; 


for (Note = 0; Note < 35; Sound(Notet+, 9)) /* Play a note once each */ 


; /* 1/2 second */ 
printf ("End\n") ; 


Assembler listing; SOUNDCA.ASM 


PRAARRRKKEKR EKER ERE RK EKER KEK REE KKKAEKRE RK EEKAKEEKREKEKRERERKEEKEKEKE » 


SOUNDCA 


> 
* 


+ 
+ 


’ 7, 
? , 
ax Task : Creates a function suitable for inclusion in *; 
Peas C codes, which enables C to play notes in the *; 
ei 3rd, 4th and 5th PC musical octave ms 
ax Si abs is es is si i a emi cus GS c's Si’ es Ss ess is ers as cubs ce mvs cal Sos cs nuns seo en cls eau al ces ems a em ees cuss Wh se utp ta Cn > tis ins in ie fe Ss * 
7s Author : MICHAEL TISCHER x 
ad Developed on : 08/15/1987 ws 
as Last update : 05/26/1989 xs 
;* <i ni une ai tal Sin cl! ines ch Sis tk i ch: i in Ss iS nis is ll ei el cs ei lei eid ivi i oii sh sb em eo ae i Ca cai as 
zs assembly : MASM SOUNDCA; +5 
PERAK EKKKEKEKKEKEKEKKEKEKEKKEKEKEKEKKEKEKEKEKEKEKEKKKEKEEKREKEKEREEKEEKREREEEEKKEEKEKE © 


IGROUP group text 7Merging of program segment 
DGROUP group const, bss, data 7Merging of data segment 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


public Sound ;Make function public (accessible to 
. ;other programs) 


CONST segment word public 'CONST';This segment denotes all read-only 
CONST ends 7constants 


_BSS segment word public 'BSS' j;This segment denotes all static, non- 

_BSS = ends zinitialized variables 

_DATA segment word public 'DATA' ;This segment contains all initialized 
7global and static varibles 


old time dw (?), (?) ;Address of old timer interrupt 
s counter db (?) ;Counts duration of notes in 
71/18 second increments 


s endit db (?) zIndicates whether note already played 
tones dw 9121,8609,8126,7670 ;Note values for octave 3 

dw 7239, 6833, 6449, 6087 

dw 5746,5423,5119, 4831 

dw 4560, 4304, 4063,3834 ;Note values for octave 4 

dw 3619,3416, 3224, 3043 
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_DATA end 


’ 


dw 2 
dw 2 
dw 1 
dw 1 


s 


873, 2711, 2559, 2415 
280, 2152, 2031,1917 ;Note values for octave 5 
809,1715,1612,1521 
436,1355,1292,1207 


_TEXT segment byte public ‘CODE' ;Program msegment 


y-~ SOUND: PlayS a NOE ---- nnn nn rn rrr rn rn 
t-- Call from C : Sound((int) Note, (int) Duration); 
7~7- Output : none 
t-- Info : Note is the number of the note relative to 3rd octave 
77 C 
is Duration=duration of the note in 1/18-sec. increments 
Sound proc near 
push bp 7Push BP onto stack 
mov bp,sp 7Transfer SP to BP 
7-- Modify timer interrupt for user application -------------- 
mov word ptr cs:setds+1,ds ;Store DS for new timer interrupt 
mov ax,35lch ;Get timer interrupt's address 
int 21h 7Call DOS interrupt 
mov old time, bx zNote offset address and segment 
mov old time+2,es ;address of old interrupt 
mov word ptr cs:stjumpt+l,bx ;Save for new timer interrupt 
mov word ptr cs:stjumpt+3,es ; 
mov bx,ds ;Place DS in BX 
push cs ;Push CS onto stack 
pop ds zand pop off DS 
mov dx,offset sound ti ;Offset address of new timer routine 
mov ax,25lch 7;Set new timer routine 
int 21h 7Call DOS interrupt 
mov ds,bx 7Restore DS 
mov al,182 7Get ready to generate tone 
out 43h,al 7Send value to timer command register 
mov bx, [bpt+4] 7;Get note 
xor bh,bh 7;BH for addressing of note table = 0 
shl_ bx,1 ;Divide note number (for word table) 
mov ax, [tones+bx] 7Get note value 
out 42h,al 7Pass low byte to timer counter register 
mov al,ah 7Pass high byte to AL 
out 42h,al zand to timer counter register 
in al, 61h ;Read speaker control bit 
or al,11b 7Two lowest bits activate speaker 
mov s_endit,1 7Still have to play note 
mov dl, [bp+6] 7Get note duration 
mov s counter,dl zand store it 
out 61h,al 7Turn on speaker 
play: cmp s_ endit,0 ;Note ended? 
jne_ play 7NO --> wait 
in al,6l1h 7Read speaker control bit 
and al1,11111100b 7;Clear two lowest bits to 
out 61h,al ;disable speaker 
y7- re-activate original timer interrupt --------------------- 
mov cx,ds 7Note DS 
mov ax, 25lch 7;Set function no. for interrupt vector 
lds dx,dword ptr old time ;Load old address into DS:DX 
int 21h 7Call DOS interrupt 
mov ds, cx 7;Return DS 
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mov sp,bp ;Restore stack pointer 
pop bp 7;Pop BP off of stack 
ret 7Return to calling program 


_Sound endp 


7-—- new timer interrupt -------9 9-99-92 nnn enn nner 


sound ti proc far ;Call this 18 times per second 
push ax 7Push AX and DS onto stack 
push ds 
setds: mov ax,0000h ; Transfer C to DS 
mov ds,ax ‘4 
dec s counter ;Decrememt time counter 
jne st_endit zIf still unequal to 0 then end 
mov s_ endit,0 7Signal end of note duration 
st_endit: pop ds 7Pop value off of DS (reset to old value) 
pop ax 7Get AX from stack again 
stjump: db OEAh,0,0,0,0 7FAR-JUMP to old timer interrupt 


sound ti endp 


_text ends 7;End of program segment 
end 7End of assembler source 
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Chapter 10 


Accessing and Programming 
the Video Cards 


Direct 


This chapter explains methods of programming the most popular video cards on 
the PC market. Even though the video cards mentioned here differ in their 
capabilities, they are all based on the same basic principle. High level languages 
such as BASIC, Pascal or C often have their own specific keywords and commands 
for controlling screen display. However, many of these commands merely call 
BIOS or DOS functions, which are both slow and inflexible in execution. 


access 


Direct access to the video card is the alternative. Applications from Lotus 1-2-3® 
to dBASE® use direct video access coding, to guarantee both speed and that 
element of extra control over the video display. The main disadvantage: 
Programming in assembly language is required, since the communication here 
occurs at the system level. This chapter examines the programming needed for the 
best known video cards on the market: 


. Monochrome Display Adapter (MDA), also called a monochrome card 
° Color Graphics Adapter (CGA), also called a color card 

° Hercules Graphic Card (HGC) 

° Enhanced Graphic Adapter (EGA) 

. Video Graphics Array (VGA) 


Most of the graphic cards on the market are compatible with one of the cards 
mentioned in this chapter, and the descriptions stated here should apply to those 
cards. 
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Video Graphics Array (VGA) 


What's 


Speed 


This also applies to the newest generation of video cards, the VGA card. Designed 
in conjunction with the IBM PS/2 system, the VGA card is now available to the 
general public as an add-on card. This chapter demonstrates some general features 
of the EGA and VGA, as well as a few programming techniques. 


needed 


Before a video card can display a character or graphic pixel on a monitor screen or 
CRT (cathode ray tube), the card must know the following: 


° which character or graphic pixel to display 
° The color of the character or pixel 
° The location on the screen at which it should be displayed. | 


PC video cards include RAM which collects information about every CRT screen 
pixel or screen location. This RAM memory is called video RAM and interfaces 
with the PC's RAM, allowing direct access from the microprocessor. 


Rapid screen changes are important in word processing programs and other PC 
applications. For example, if you are paging through a word processing document 
at high speed, a 25-line, 80-column screen requires the transmission of 2,000 
characters through the video card at one time. Fast data transfer is even more 
important for high-resolution graphics. For example, the 200x640-pixel IBM 
Color Graphics Adapter transmits 128,000 pixels of graphic information at a time. 


Display modes 


Each type of video card can have more than one display mode. Text and graphics 
display may be very different from one another. The monitor cannot distinguish 
between the two modes; it just processes the graphic information sent by the video 
card (or video controller). For the programmer and the video card, the modes require 
completely different programming techniques. 


Graphic mode and text mode 
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Graphic mode stores the color of a screen pixel in one or more bits, then transmits 
the contents of video RAM more or less directly to the screen. Text mode uses a 
different method. The ASCII code of a character is stored in video RAM for each 
screen location. When the video controller displays the screen, it obtains the 
character pattern of the ASCII code from the ROM chip on the video card, then 
converts the code into a character matrix of pixels. This pattern then passes to the 
monitor and appears on the screen. 
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PC text mode uses the 256-character extended character set (see Appendix I). Since 
these characters are numbered sequentially from 0 to 255, one byte is enough for 
each screen position to display the character at the proper position. 


Attribute bytes 


Every screen position has an attribute byte which indicates the color or display 
attribute of the character (underlined, blinking, inverse video, etc.). This means 
that two bytes are needed for each position on the screen. Therefore, a total of 4000 
bytes are required for a 25-iine, 80-column screen. This appears to be a lot of 
memory at first glance, but is fairly small when compared to the memory 
requirements for bit-mapped graphic screen. In graphic mode, each dot is 
represented by one or more bits. A resolution of 640x200 pixels requires 128,000 
bits (16K). 


Another advantage of text mode is the simplicity in exchanging one character for 
another on the screen. The bit-map mode has its own advantages. Besides graphic 
displays, text can be displayed as individual dots whose pattern is derived from a 
character table in RAM installed by the user. This means that the user can design 
his own fonts (character sets). 
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10.1 Anatomy of a Video Card 


The figure below shows the individual hardware components of a video card. The 
Starting point for creating the picture is always the video RAM. This video RAM 
contains information about the characters to be displayed, and their display 
attributes (color, style, etc.). 


Getting to the screen 


The character generator first accesses video RAM, reading the characters one by 
one, and uses a character pattern table to construct the bit-map that will later form 
the character on the screen. The attribute controller also gets information about the 
display attributes (color, underlining, reverse, etc.) of the character from the video 
RAM. Both modules prepare this information and send it to the signal controller, 
which converts it to appropriate signals to be sent to the monitor. The signal 
controller itself is controlled by the CRT controller, which is the central point of 
video card operations. Besides the monitor and the video RAM, this CRT 
controller is one of the most important components of a video system. We will 
examine all these components in greater detail. 


CRT Signal 
controller controller 


Character Character Attribute 
pattern generator controller 


=a ep &S Beweeeawe Bes Be See wDeDe BF ewD ee BS DW 


ar eanawawv aw wwees BBeweZT DP Beet BS Ww ww 


Block diagram of a video card 


The monitor 
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The monitor is the device on which the video data is displayed. Unlike the video 
card, the monitor is a "dumb" device. This means it has no memory and cannot be 
programmed. All monitors used with PCs are raster-scan devices, in which the 
picture is made up of many small dots arranged in a rectangular pattern or raster. 


When forming the picture, the electron beam of the picture tube touches each 
individual dot and illuminates it if it is supposed to be visible on the screen. This 
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is done by switching on the electron beam as it passes over this dot, causing a 
phosphor particle on the picture tube to light up. 


Color monitors 


While monochrome monitors need only one electron beam to create a picture, 
color monitors use three beams which scan the screen simultaneously. Here a 
screen pixel consists of three phosphor particles in the basic colors of light: red, 
green, and blue. Each color has a matching electron beam. Any color in the 
spectrum can be created by combining these three colors and varying their 
intensities. 


But since an ionized phosphor particle emits light for only a very brief period of 
time, the entire screen must be scanned many times per second to create the 
illusion of a stationary picture. PC monitors perform this task between 50 and 70 
times per second. This repeated re-scanning is called the refresh rate. One rule of 
thumb for this rate: The faster the refresh rate, the better quality the picture. 


Each new screen image begins in the upper left corner of the screen. From there 
the electron beam moves to the right along the first raster line. When it reaches the 
end of this line, the electron beam moves back to the start of the next line down, 
similar to pressing the <Return> key on a typewriter. The electron beam then 
scans the second raster line, at the end of which it moves to the start of the next 
raster line, and so on. Once it reaches the bottom of the screen, the electron beam 
returns to the upper left corner of the screen and the process starts over again. The 
illustration below shows the path of the electron beam. 


Remember that the movement of the electron beam is controlled by the video card, 
not by the monitor itself. 


Picture tube 


Vertical 


Horizontal 


° ° a 
ON: ——= OFF: wx 


Electron beam scan movement 
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The resolution of the monitor naturally controls the number of raster lines and 
columns which the electron beam scans when creating a display. Thus, a monitor 
which has only 200 raster lines of 640 raster columns each clearly cannot handle 
the high resolutions of an EGA card at 640x350 pixels. The four monitor types 
used with a PC generally have the following resolutions: 


| Monochrome | 350, | 720 
| color | 200 
VEGA 850 
varies 


up to 600 | varies, up to 800 | 


The CRT controller 


The CRT Controller or CRTC is the heart of a video card. It controls the operation 
of the video card and generates the signals the monitor needs to create the picture. 
Its tasks also include controlling light pens, generating the cursor and controlling 
the video RAM. 


To inform the monitor of the next raster line, the CRTC sends a display enable 
signal at the start of each line, which activates the electron beam. While the beam 
moves from left to right over each raster column of the line, the CRTC controls 
the individual signals for the electron beam(s) so that the pixels appear on the 
screen as desired. At the end of the line, the CRTC disables the display enable 
signal so that the electron beam's return to the next raster line doesn't make a 
visible line on the screen. The electron beam is directed to the left edge of the 
following raster line by the output of a horizontal synchronization signal. The 
display enable signal is again enabled at the start of the next raster line, and the 
generation of the next line begins. 


Overscan 
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Since the time that the electron beam needs to return to the start of the next line is 
less than the time the CRTC needs to get and prepare new information from the 
video RAM, there is a short pause. But the electron beam cannot be stopped, so 
we get something called overscan, which is visible as the left and right borders of 
the actual screen contents. Although this is an undesirable side effect in one sense, 
it is useful because it prevents the edges of the screen contents from being hidden 
by the edge of the monitor. If the electron beam is enabled while it is traveling 
over this border, a color screen border can be created. 
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Screen contents Y raster lines 


screen border 
|—____—_—.—_——» : raster columns 


Rasters and overscan on @ screen 


horizontal 
overscan 


Once the electron beam reaches the end of the last raster line, the display enable 
signal is disabled, and a vertical synchronization signal is sent. The electron beam 
returns to the upper left comer of the screen. Again the display enable signal is re- 
enabled and scanning again begins. 


Pause and overscan 


Signal 


As with the horizontal electron beam return, a pause results which is displayed in 
the form of overscan, creating a vertical screen border. 


timing 


The timing of individual signals varies from video mode to video mode. For this 
reason, the CRTC has a number of registers which describe the signal outputs and 
their timing. The structure of these registers and how they are programmed will be 
discussed in the remainder of this section. Many of these registers come from the 
registers of the 6845 video controller from Motorola. This controller is used in the 
MDA, CGA, and Hercules graphics cards. The EGA and VGA cards use a special 
VLSI (very large scale integration) chip as a CRTC, and its registers are somewhat 
more complicated. The techniques described here are intended as general 
descriptions for all video cards. 
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Registers the 6845 video controller from Motorola 


Reg. [Meaning ——SS—CSCSSSSSCC*~“‘(S CAS 
Write 
oz | Horizontal synchronization signal after ...char | Write 
04H 
06 
fos interlace mode_———SCSCSSSSSCTCTCS rite 
foaH | Starting line of screen cursor_—~=S=é—“‘*‘*~*S*™*S*S*™*S*™~™~S~*d‘itows~—=*d 
[Ending line of screen cursor_~—~—Ss*é=“*é“‘*S*~*“‘*“‘s*‘“s*s*s~s*s*~*S 


OBH Ending line of screen cursor 


These registers, like all of the other registers on the video card, are accessed via I/O 
ports with the assembly language instructions IN and OUT. The registers of the 
CRTC are accessed through a special address register, rather than directly from the 
address space of the processor. The number of the desired CRTC register is written 
to the port corresponding to this address register. Then the contents of this register 
can be read into a special data register with the IN assembly language instruction. 
If a value is to be written to the addressed register, it must be transferred to the data 
register with the OUT instruction. Then the CRTC automatically places it in the 
desired register. These two registers are actually found at successive port addresses, 
but these addresses vary from video card to video card. 


We will include tables throughout the chapter to describe the contents of individual 
CRTC registers under the various video modes. Here's an example which shows 
how the contents of these registers are calculated and how the individual registers 
are related to each other. If you try some of these calculations with your calculator 
or PC, you will notice that some of them do not work out evenly. But since the 
registers of the CRTC hold only integer values, they will be rounded up or down. 


The basis for the various calculations are the bandwidth and the horizontal and 
vertical scan rates of a monitor. 


Bandwidth and scan rates of different video cards 


Video system Resolution [| Bandwidth Vert. scan rate 
rate 


MDA fs 720 x 350 6.257 MHz 50 Hz * | 18.43 KHz* 


1 
ICCA ti ststi‘i‘sSC*iSC AD x: 200 14.318 MHz 60 Hz 15.75 KHz 
jHGC rt Cttsti<‘SCSCSCSC‘*é:C AO x «200 14.318 MHz 50 Hz 18.43 KHz 


GC 
640 x 350 16.257 MHz 60 Hz 21.85 KHz 
640 x 200 14.318 MHz 60 Hz 15.75 KHz 
720 x 350 16.257 MHz 50 Hz 18.43 KHz 


| (*MHz=Megahert z, KHz=Kilohertz, Hz=Hertz 


The bandwidths in the figure above specify the number of points which the 
electron beam scans per second, and is therefore also called the point or dot rate. 
The vertical scan rate specifies the number of screen refreshes per second, while the 
horizontal scan rate refers to the number of raster lines which the electron beam 
scans per second. 
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Starting with these values, let's practice calculating the individual CRTC register 
values for the 80x25 character text mode on a CGA card. 


Dividing the bandwidth by the horizontal scan rate we get the number of pixels 


(screen dots) per raster line. 
Bandwidth 14.318 MHz 
+ Horizontal scan rate 15.570 KHz 
Pixeis per line 515 


Since the CRTC registers generally refer to the number of characters rather than 
pixels, this value must be converted to the number of characters per line. This is 
done by dividing the number of pixels per line by the width of the character 
matrix. On the CGA card this is eight pixels. 


Pixels per line 919 
+ Pixels per character 8 
Characters per line 114 


This value, decremented by one, is placed in the first register of the CRTC and 
specifies the total number of characters per line. In the second register we load the 
number of characters that will actually be displayed per line. The 80x25 character 
text mode usually offers 80 characters. 


The difference between the total and the number of characters actually displayed per 
line is the number of characters which can be displayed between the horizontal 
return and the overscan. The difference in this case is 34 characters. 


_ The duration of the horizontal beam return must be entered in the fourth register of 
the CRTC. This register stores the number of characters which could be displayed 
during this time, rather than the actual time duration. The monitor specifications 
define this instead of the video card itself. As a rule this number is between 5% and 
15% of the total number of characters per line. A color monitor uses exactly ten 
characters. 


This leaves 24 characters for the overscan (the horizontal screen border). The third 
CRTC register specifies how these characters are divided between the left and right 
screen borders. This register specifies the number of character positions which will 
be scanned before the horizontal beam return occurs. The BIOS specifies the value 
90 here, or after ten characters have been displayed for the screen borders. The 
remaining 14 characters are placed at the start of the next line and form the left 
screen border. 


The calculations for the vertical data, the number of vertical lines, the position of 
the vertical synchronization signal, etc., follow a similar scheme. The first 
calculation is the number of raster lines per screen. This results from the division 
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of the number of lines displayed per second by the number of screen refreshes per 
second: 


Pixels per line 919 
+ Pixels per character 8 
Characters per line 114 
Horizontal scan rate 15.750 KHz 
+ Screen refreshes 60 Hz 
Raster lines 262 


Since the characters in CGA text mode are eight pixels high by eight pixels wide, 
we again divide by eight to get the number of text lines per screen: 


Raster lines 262 
+ Pixels per character 8 
Lines per screen 32 


This result must be decremented by one and then loaded into the fifth register of 
the CRTC. The number of displayed lines is loaded into the seventh register. Since 
seven fewer lines are displayed than are actually available, these extra lines are used 
for the vertical beam return and overscan, whereby the vertical beam return begins 
after the 28th line. 


The character height must be decremented by one and loaded into CRTC register 
nine. The decrement results is 7 in this example. This value also determines the 
range for the values loaded into register ten and eleven. They specify the first and 
last raster lines of the screen cursor. The cursor position is determined by the 
contents of registers 14 and 15. They refer to the distance of the character from the 
upper left corner of the screen, instead of line and column. This value is calculated 
by multiplying the cursor line by the number of columns per line and then adding 
the cursor column. The high byte of the result must be loaded into register 14 and 
the low byte in register 15. 


The video RAM area 
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The contents of registers 12 and 13 determine the area of video RAM displayed on 
the screen. To understand these registers, we first need to know something about 
the way video RAM is organized. 


The third component of the video system determines what will eventually be 
displayed on the screen. In text mode, the video RAM contains the ASCII codes of 
the characters to be displayed and their attributes. While the organization of video 
RAM in this mode is identical for all of the video cards discussed here, the 
organization for graphic mode varies from card to card. The description of each card 
discusses the way video RAM organizes graphic modes (more on this later). 
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As the illustration below shows, each screen position occupies two bytes in video 
RAM. The ASCII code of the character to be displayed is placed in the first of 
these two bytes, the one with the even address. By using eight bits per character 
code, a maximum of 256 different characters can be displayed. 


RAM 


0900-0000 


80 Columns 


ak 


HEH 1 HUAN ETLEEAETAALELAH ALTA 


25 Characters @ 
DEUNERUSSANAIESBNONI AUNNN) HUH 


= 


ae oe 
3 
Fa 


ieee 
Ha 


1 
Hit Ht Hit 
DEQUIEAIACEOST EREtE 


HAR 


EHH he EEE HEP EPHEHHEHE HEHEHE 
Sola eeoeee 


q SeSSGEESSODERDEEODEY 


Attribute ASCII- 
Code 


Normal text mode structure in video RAM 


After the ASCII code, and always at an odd offset address, follows the attribute 
byte, which defines the appearance of the character on the screen. The attribute 
controller divides it into two nibbles, whereby the upper nibble (bits four to seven) 
describes the character background, and the lower nibble (bits zero to three) 
describes the character foreground. This results in two values between zero and 
fifteen which are interpreted depending on the type of monitor attached. With a 
color monitor (and a CGA or EGA card) both values select one of 16 possible 
colors. Each character on the screen can thus have its own foreground and 
background colors. 


A monochrome monitor cannot display colors, regardless of the adapter. Here the 
attribute controls whether the character is displayed at high or low intensity, 
inverse, or underlined. 
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Character organization in video RAM 


To access video RAM, you must know how the individual characters are organized 
within this memory. This organization is similar to character display on the 
screen. 


The first character on the screen (the character in the upper left corner) is also the 
first character in video RAM, located at offset position OOOOH. The next character 
to the right is located at offset position 0002H. All 80 characters of the first screen 
line follow in this manner. Since each screen character takes two bytes of memory, 
each line occupies 160 bytes of RAM. The first character of the second screen line 
follows the last character of the first line, and so on. oe 


Finding character locations in video RAM 
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You can easily find the starting address of a line within video RAM by 
multiplying the line number (starting with zero) by 160. To get from the 
beginning of the line to a character within the line, the distance of the character 
from the start of the line must be added to this value. Since each character takes 
two bytes, this is done simply by multiplying the column number (also starting at 
zero) by two. Adding both products together yields the offset position of the 
character in the video RAM. These calculations can be combined into a single 
formula: 


Offset _position(row, column) = row * 160 + column * 2 


Note: Since only 40 characters per line are displayed in 40-column video 
modes, the factor 80 must replace the original 160. 


The RAM memory of the video card is integrated into the normal RAM of the PC 
System, so you can use normal memory access commands to access video RAM. 
You must know the segment address of video RAM, which is used together with 
the formula above to find the offset position. Section 10.7 shows how this can be 
done easily in assembly language, BASIC, Pascal, and C. 


Now that we have discussed the most important similarities between the four video 
cards, the following four sections describe the capabilities of these cards. In 
addition, these sections explain how these capabilities can be used for optimal 
screen output. 
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10.2 The IBM Monochrome Card 


The IBM Monochrome Display Adapter, or MDA, is probably the oldest of the 
video cards. This card is based on the Motorola 6845 video controller, which is an 
intelligent peripheral chip. The 6845 controller constructs a display by generating 
the proper signals for the monitor from video RAM. 


This card is excellent for text display. This is achieved with a 9x14 character 
matrix, which permits high-resolution character display. The format of this matrix 
is unusual since a character generator containing the bit pattern of each character 
can only produce characters 8 pixels wide. Characters from the IBM character set 
may not connect with each other (e.g., using box characters to draw a box). A 
Circuit on the graphics card sidesteps this disadvantage by copying the eighth pixel 
of the line into the ninth pixel for any characters whose ASCII codes are between 
BOH and DFH. This allows the horizontal box drawing characters to connect. 


Column 01 234 5 67 

Row “| | ae = 
‘ll i ia 
ZaasThlUlC<(<[h'hnthOUCU 
a oe ee | ae | 
4, | f | ae | 
‘| | ia 
- Aa Pe 
i a el a ae 
2 | ae 
9] {| =— 
tof | a Ba 
| a 
12{_ | | bea! = 
i3{_ [| = = 


Coding stored in ROM character set 


Monochrome display adapter—9x14 character matrix 


The character generator requires one byte for each screen line: one bit per pixel, 
eight bits per line. Each character requires 14 bytes. The complete character set has 
a memory requirement of almost 4K, stored in a ROM chip on the card. For some 
reason the card has an 8K ROM, leaving the second bank of 4K unused. 


Video RAM on the MDA 
The video RAM of the card starts at address BO00:0000 and extends over 4K (4,096 
bytes). Since the screen display only has space for 2,000 characters and requires 
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only 4,000 bytes of memory for those characters, the unused 96 bytes at the end of 
video RAM are available for other applications. 


The following figure shows the meanings of the different values representing the 
attribute byte: 


7 6 2 4 3 2 1 O bit 


Character color 


Character intensity 
O=normal 
1=high intensity 


Background color | 


Blinking (or background 
10-=off intensity) 
T=on 


Attribute byte values—1BM monochrome display adapter 


Any combination of bits can be loaded into this byte. However, the MDA only 
accepts the following combinations: 


7 6 0 


a. 4 3 2 1 
Ptefefefs fo] of e] re cnaracter miack on piace 
pe fo} ofojefo] ofr underlined character (white on black) | 


Pep ef ete fs] 2] 2] mite cnaracter on black 
fe fifafafefo| ofo| Black character on white (inverse) 


fe fafafatefa] apa No character (white on white) 


Byte combinations—1BM monochrome display adapter 


Besides these bit combinations, bits 3 and 7 of the attribute byte can be set or 
unset. Bit 3 defines the intensity of the foreground display. When this bit is set, 
the characters appear in higher intensity. Bit 7's purpose varies with the contents 
of the control registers (more on this later). For now, all you need to know is that 
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bit 7 can either enable blinking characters, or enable an intensity matching the 
background color. 


Monochrome cards have two more registers available: the control register and the 
status register. 


Bit 7 of the attribute 
byte: 

O=bright background 
1=blinking 


Control register 
MDA control register 


The control register located at port 3B8H controls the monochrome display 
adapter's different functions. As the figure below shows, only bits 0, 3 and 5 are of 
importance. Bit 0 controls the resolution on the card. Although the card only 
supports one resolution (80x25 characters), this bit must be set to 1 during system 
initialization. Otherwise the computer goes into an infinite wait loop. Bit 3 
controls the creation of a visible display on the monitor. If bit 3 is set to 0, the 
screen is black and the blinking cursor disappears. If bit 3 is set to 1, the display 
returns to the screen. Bit 5 has a similar function: If bit 7 in the attribute byte of 
the character is set to 1, it enables blinking characters. If bit 7 contains the value 
0, the character appears, unblinking, in front of a light background color. This 
means that bit 7 of the attribute byte acts as an intensity bit for the background. 
This register can only be written. This makes it impossible for a program to 
determine whether the display is turned on or off. The normal value for this 
register is 29H, meaning that all three relevant bits default to 1. 
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Horizontal 
synchronization 
signal: O=off, 1=on 


0=Current pixel off 
1=Current pixel on 


Status registers (3BAH) 


MDA status register 


Only bits 0 and 3 are used in the status register; all the other bits must contain the 
value 1. Unlike the control register, programs can read this register, but register 
contents cannot be changed by program code. 


Horizontal synchronization 


Bit O indicates if a horizontal synchronization signal is being sent to the display 
screen. The video card sends this signal after creating a screen line (not to be 
confused with a text line, which consists of 14 screen lines) on the screen. This 
signal informs the electron gun, which "draws" the picture on the screen, that it 
should return to the left border of the current screen line. In this case the bit has 
the value 1. Bit 3 contains the value of the pixel where the electron beam is 
currently located. A 1 signals that the pixel is visible on the screen and 0 means 
that the screen remains black at this location. 


MDA internal registers 
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Besides the two registers directly connected to the hardware of the monochrome 
display adapter, the 6845 video processor contains a series of internal registers. 
These 18 registers are open to user access through the 6845 index register and data 
register. The index register is connected to port address 3B4H, the data register at 
port address 3B5H. You can only write to the 6845 registers—you cannot read data 
from them. 


When you enter a value into one of the 18 registers, the number of the register (0- 
17) passes first into the index register. Then the value which is transmitted to the 
register passes into the data register. The 6845 then transmits the indicated value to 
the proper register. Most of these 18 registers should not be modified, since they 
contain important data about the screen structure (e.g., synchronization signals) 
and incorrect values in these registers can damage the monitor. The following table 
shows the meanings of the individual registers and the values which ensure a 
correct display. 
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Registers of the CRTC register in 80x25 text mode 
on the Monochrome Display Adapter (MDA) 


Content 


Duration of horizontal synchronization signal in char. 
Total vertical character 
Adjust vertical character 


Display vertical character 
Vertical synchronization signal after ...char 


01H 
02H 
03H 
05H 
07H 5 
Interlace mode 

Number of scan lines per screen line 

Starting line of blinking screen cursor 

Ending line of blinking screen cursor 


Starting address of displayed screen page (low byte) 
Starting address of displayed screen page (high byte) 


Character address of blinking screen cursor (low byte) 
10H 
11H 


Freee eee 


Character address of blinking screen cursor (high byte) 


Light pen position (high byte) 
Light pen position (low b te) 
*not available on MDA 


TUT 


The following program makes full use of the monochrome display adapter's 
capabilities. It was written in assembly language. The individual routines are fully 
documented and require no additional explanation. The demonstration program built 


into the listing shows practical application of the individual routines. 


Assembler listing: VMONO.ASM 


ZF RARER EK KEKE KR EK KEKE KKK KKK EEE AKER EEK ARK EKEREEKEKEEKKEKEKEKKKKEKK 0 


v 
= VMONO ar 
tial “ci ce il cn i “a il iv Se is i Sh ie csi, dig i eC sig see el in Spi ps5 cs ete er a ise ls ce es Wa ee i mc bs i es a Wi wih tii ew Sh soc Si es dom as wl ial 
;* Task : makes some elementary functions available for *; 
7s access to the monochrome display screen “s 
rhe Sa hs eek cm ams cin Sc ee ms sos es ain ets sm cm ts veh “cin ‘en cuca Guus ‘ln cence Sous Sess iss ‘mums cease ceo vaie Cems ce tie an cus ims mus sas enss oes sas tes‘ Gn ns eas Sb cm as “ts id Svs nin ew mes ccs oe aca se we 
had Info : all functions subdivide the screen ® 9 
7 into columns 0 to 79 and lines 0 to 24 ws 
ox ae Se ere eee nee ee SUP GD Cee ee aD GED ED cee Ge cm Oe ee CED GE Ge eae Oe TD ES a ee CE GD RD ee eet GD ED mE GD CE es GD es Oe ce ED Oe Oe ee OS a om aw Ge a ow Om am ema a was an *e 
tA tA 
oe Author : MICHAEL TISCHER ba 
7* Developed on : 8/11/87 *s 
ze Last Update : 6/14/89 xe 
rial es Sai Sas cs Se na aes: sme cnc cass oc es ec esse ces ccs cess ce fn ca “acc Sess ‘ches ‘0s io how im cad ewes ws" a tn ee es es ln ke oe ew ee ws hn Oe ed a ee *s 
ss assembly : MASM VMONO; xs 
hed LINK VMONO; *; 
ex ci ‘cn ‘ms isis i mas uh cus ams‘ i's so cl iin ln sn’ nec Tosi ua“ mah ils co car ct mb ‘cs ton “am Ses cen ou Ges vm‘ Ws lo acs ns mn uh mss Sem as un sii ee am ei ke 

" 
;* Call : VMONO *? 
FRR RRR EKER ERE KEK KEK ERE KEKE ERK AKER KEKE ERE KERKEKREKEKRKKEKEKEKEEE 9 


7== ConstantS ==sssss=ssssssssseesssasasssas essa ss sas ess SSS SSSSsSSsSss 
CONTROL REG = O3B8h ;Control register port address 
ADDRESS 6845 = 04B4h 76845 address register 

DATA_6845 = 03B5h 76845 data register 

VIO_SEG = QBOO0Oh ;Segment address of video RAM 
CUR_START = 10 7Register # CRTC: Starting cursor line 
_CUR_END = 11 ;Register # CRTC: Ending cursor line 
CURPOS_HI = 14 7Register # CRTC: Cursor pos. hi byte 
CURPOS_LO = 15 ;Register # CRTC: Cursor pos. lo byte 
DELAY = 20000 ;Counter for delay loop 
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stack segment para stack ;Definition of stack segment 
dw 256 dup (?) 3256-word stack 
stack ends 7End of stack segment 
7== Data s=ssesessssessessaesssesess ess ssesee sss seseEEe seers s SSeS s 
data segment para 'DATA' ;Define data segment 


strl db “a" ,0 
str2 db “ >PC SYSTEM PROGRAMMING< "*,0 
str3 db " window 1 #0 


str4 db * window 2 “,0 
str5 db * the program is stopped by “ 
db “ pressing a Key.... ",0 


initm db 13,10,"VMONO (c) 1987 by Michael Tischer",13,10,13,10 
db “This demonstration program only runs with "“ 
db " a monochrome",13,10,"“display card. If your PC " 
db “has another type of display card,",13,10 
db “please enter <s> to stop the “ 
db “ program.",13,10, "Otherwise press any " 
db “key to start ",13,10 
db “the program ...",13,10, "S$" 


p= Data =sesssssssssesnsnss Sesser sr sss SSE SSS SSS SSS SSS SSS SSS SSS SSS SsSSSs 
linen dw 0*160,1*160,2*160 ;Start addresses of the lines as 

dw 3*160,4*160,5*160 ;offset addresses in the video RAM 

Gw 6*160,7*160,8*160 

dw 9*160,10*160, 11*160, 12*160,13*160, 14*160,15*160, 16*160 

dw 17*160,18*160, 19*160, 20*160, 21*160, 22*160, 23*160, 24*160 


data ends zEnd of data segment 


code segment para 'CODE' ;Definition of the CODE segment 
assume cs:code, ds:data, es:data, ss:stack 


demo proc far 
mov ax,data 7Get segment address of data segment 
mov ds,ax rand load into DS 
MOV e€S,ax 7as well as ES 


7-- Display initial msg./wait for input ---------------- 


mov ah,9 7String output function 
mov dx,offset initm ;Address of initial message 
int 21h 7;Call DOS interrupt 21H 
xor ah,ah 7;Get function number for key 
int 16h 7Call BIOS keyboard interrupt 
cmp al,"s* ;was <s> entered? 
je ende 7YES --> end program 
cmp al,“S" ;was <S> entered? 
jne startdemo 7;NO --> start demo 

ende: mov ax, 4c00h :Function number for program end 
int 21h 7Call DOS interrupt 21H 
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startdemo label near 


demol1: 


demo2: 


arrow: 
arrow0: 


arrowl: 


mov cx, 0d00h ;Enable full cursor 

call cdef 

call cls ;Clear screen 

g-~ Fill screen with ASCII characters ------------- 

xor di,di ;Start in upper left corner 

mov si,offset strl ;Offset address of stringl 

mov cx, 2000 72,000 characters fit on the screen 
mov al,O7h swhite letters on black background 
call print ;Display string 

inc stril sIncrement character in test string 
jne demo2 ;NUL code suppressed 

inc stri 

loop demol 7;Repeat output 


j-- Create window 1 and 


mov 
mov 
mov 
call 
mov 
mov 
call 
Mov 
call 
mov 
mov 
call 
mov 
call 
mov 
call 
xor 
mov 
call 


bx, 0508h 
dx,1316h 

ah, 07h 

clear 

bx, 3C02h 

dx, 4A10h 

clear 

bx, 0508h 

calo 

si,offset str3 
ah, 70h 

print 

bx, 3C02h 

calo 

si,offset str4 
print 

di,di 
si,offset str5 
print 


;Upper left corner of window 1 
;Lower right corner of window 1 
;White letters, black background 
7;Clear window 1 

;Upper left corner of window 2 
;Lower right corner window 2 
;Clear window 2 

;Upper left corner of window 1 
;Convert to offset address 
;Offset address string 3 

7;Black characters, white background 
;Display string 3 

;Upper left corner of window 2 
;Convert to offset address 
7Offset address string 4 
;Display string 4 

;Upper left display corner 
;Offset address string 5 
;Display string 5 


7-- Display program logo ---------~--- 3-939 een 


MOV 
call 
mov 
mov 
call 


bx, LEOCh 
calo 


-Si,offset str2 


ah, OFOh 
print 


7Column 30, line 12 
;Convert offset address 
7;Offset address string 2 
;Inverse blinking 
;Display string 2 


;-— Fill window with arrows ------~-<-------------------- 


xor 
mov 
push 
mov 
mov 
sub 
shr 
or 
je 
mov 
rep 
mov 
mov 
rep 
mov 
sub 
shr 
or 
je 


mov 


ch, ch 
bl,1 
bx 
di,offset str3 
€1,15 
cl,bl 
cl,l 
cl,cl 
arrowl 
al, iy a 
stosb 
cl,bl 
al,"%**" 
stosb 
c1,15 
cl,bl 
cl,1 
cl,cl 
arrow2 
al,™ . 


sHi-byte of the counter to 0 

; Asterisk 

7;Push BX on the stack 

;Draw arrow line in string 3 
;Total of 15 characters ina line 
;Calculate number of spaces 
;Divide by 2 (for left half) 

7;No blanks ? 

7YES --> ARROW1 


;Draw blanks in string 3 
sNumber of asterisks in counter 


7Draw stars in string 3 

7Total of 15 characters ina line 
7;Calculate number of blanks 
;Divide by 2 (for right half) 

3;No blanks? 

7YES --> ARROW2 
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rep stosb ;Draw blanks in string 3 
arrow2: mov bx,0509h ~ sbelow the first line of window 1 

call calo _ 7Convert to offset address 

mov si,offset str3 ;Offset address string 3 

mov ah,07h ;White characters, black background 
call print ;Display string 3 

mov bx, 3C10h zinto the lowest line of window 2 
call calo ;Convert offset address 

call print — ;Display string 3 

f-~- Brief pauSe@ --------n nnn nr nnn 
mov cx, DELAY ;Loop counter 

waitlp: loop waitlp 7Count loop to 0 

z-- Scroll window 1 line down ~-----------------<-------- 
mov bx,0509h ;Upper left corner of window 1 
mov dx,1316h ;Lower right corner window 1 

mov cl,l 3;Scroll down 

call scrolldn yone line 

f-- Scroll window 2 one line up ------------------------ 
mov bx, 3C03h ;Upper left corner window 2 

mov dx,4A10h . & ;Lower right corner window 2 
call scrollup 7Scroll up 

7-~- Was a key pressed? (end program) ~-----~-----~------- 
mov ah,l 7Function number for testing key 
int 16h 7Call BIOS keyboard interrupt 
jne end it 7;Keypress -> goto end of program 
7—-- NO, display next arrow ---------------<--- 
pop bx 7;Pop BX from stack again 

add bl,2 72 more stars in next line 

cmp bl,17 ;Reached 17 ? 

jne arrow0 7NO --> next arrow 
jmp arrow 7;No key --> next arrow 


77~- Get ready to end program 


end it: xor ah,ah 7Get function number for key 
int 16h 7Call BIOS-keyboard-interrupt 
mov cx, ODOCh ;Restore normal cursor 
call cdef 
call cls ;Clear screen 
jmp ende 7Go to end of program 

demo endp 

;-- SOFF: switches the display off ---------- anata ential 

g-- Input : none 

77— Output : none 

7-~ register : AX and DX are changed 

SOFF proc near 
mov dx,CONTROL REG ;Address of display control register 
in al,dx ;read its content 
and al,11110111b > wbit 3 = 0: display off 
out dx,al 7set new value (display off) 
ret rback to caller 

SOFF endp 
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7-- SON: switches the display on 9-3-9399 --<--3 3-99 - 
7—7~ Input : none 
7—-—- Output : none 
7-- register : AX and DX are changed 
SON proc near 
mov dx,CONTROL REG sAddress of display control register 
in al,dx ;Read its content 
or al,8 ;Bit 3 = 1: display on 
out dx,al 7Set new value (display on) 
ret 7Back to caller 
SON endp 


CDEF: sets 


=e Me Ss Be Re 


Q 
at 
ot | 
Fh 


register : 


the start and end line of the cursor --<----~----- 


Input : CL = Start line 
CH = End line 
Output =: none 


AX and DX are changed 


proc near 
mov al,CUR_START 7Register 10: start line 
Mov ah,cl 7;Start line to AH 
call setvk ;Transmit to video controller 
mov al,CUR_END 7Register 11: end line 
mov ah,ch 7End line to AH 
jmp short setvk ;Transmit to video controller 
cdef endp 
;-- SETBLINK: sets the blinking display cursor ------~-------------- 
77-—- Input : DI = offset address of the cursor 
77— Output : none 
7~- register : BX, AX and DX are changed 
setblink proc near 
mov bx,di ;Transmit offset to BX 
mov al,CURPOS HI ;Register 15:Hi-byte of cursor offset 
mov ah,bh ;HI-byte of the offset 
call setvk ;Transmit to video controller 
mov al,CURPOS LO ;Register 15:Lo-byte of cursor offset 
mov ah,bl ;Lo-byte of the offset 
7-- SETVK is called automatically ------------------------ 


setblink endp 


-- Input : 
-~~- Output : 
-~- register 3; 


s 
v 
e 
tA 
e 
v 
e 
v 
se 
t 


setvk proc 


mov 
out 
jmp 
inc 
mov 
out 
ret 


setvk endp 


-SETVK: sets a byte in one of the registers of the video controller -- 


AL = number of the register 

AH = new content of the register 
none 

DX and AL are changed 


near 


dx, ADDRESS 6845 ;Address of the index register 


dx, al 7;Send number of the register 
short $+2 7;Small I/O pause 

ax ;Address of the index register 
al,ah ;Content to AL 

dx,al 7;Set new content 


;Back to caller 


;~~- GETVK: reads a byte from one register of the video controllers - 
’ 


-~- Input : 


AL = number of the register 
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AL = content of the register 
DX and AL are changed 


77-—- Output 
7-- register 


getvk proc near 


mov dx,ADDRESS 6845 sAddress of the index register 


out dx,al ;Send number of the register 
jmp short $+2 

inc dx ;Address of the index register 
in al,dx :Read content to AL 

ret | ;Back to caller 


getvk endp 


7-- SCROLLUP: scrolls a window up by N lines ---------------- 
7-- Input : BL = line upper left 

BH = column upper left 

DL = line lower right 

DH = column lower right 

== CL = number of lines to scroll 

Output ; none 

register : only FLAGS are changed 

Info : the display lines released are erased 


=e Me Be Ns Ne Be Ves 


scrollup proc near 


cld zIncrement on string instructions 
push ax ;Push all changed registers on the 
push bx 7stack 
push di ;In this case the sequence 
push si 7must be observed! 
push bx 7These three registers are restored 
push cx ;from the stack before ending 
push dx 
sub dl,bl ;Calculate the number of lines 
inc dl 
sub dl,cl ;Deduct number of lines scrolled 
sub dh,bh ;Calculate number of columns 
inc dh 
call calo 7Convert upper left in offset 
mov si,di ;Record Address in SI 
add bl,cl ;First line in scrolled window 
call calo ;Convert first line to offset 
xchg si,di ;Exchange SI and DI 
push ds ;Store segment register on 
push es ;the stack 
mov ax,VIO_ SEG ; Segment address of the video RAM 
mov ds,ax sto DS 
mov eS,ax jand ES 
supl: mov ax,di ;Record DI in AX 
mov bx,si ;Record SI in BX 
mov cl,dh sNumber of column in counter 
rep movsw ;Move a line 
mov di,ax ;Restore DI from AX 
mov si,bx ;Restore SI from BX 
add di,160 ;Set next line 
add si,160 
dec dl ;Processed all lines ? . 
jne supl ;NO --> move another line 
pop es 7;Get segment register from 
pop ds ;stack 
pop dx ;Get lower right corner 
pop cx ;Read number of lines 
pop bx ;Get upper left corner 
mov bl,dl ;Lower line to BL 
sub bl,cl ;Deduct number of lines 
inc bl 
mov ah,07h ;Color : black on white 
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call clear sErase lines freed 

pop si 7CX and DX have already 
pop di zbeen read 

pop bx 

pop ax 

ret ;Back to caller 


scrollup endp 


-- SCROLLDN: scrolls a window down N lines --------------- 
-- Input : BL = line upper left 

-= BH = column upper left 

-- DL = line lower right 

= DH = column lower right 

== CL = number of lines to scroll 

-- Output : none 

register : only FLAGS are changed 

-- Info : display lines released are erased 


= 
= 


=e Re Te Re Re Ne Ve Ne Ve 


scrolldn proc near 


cld ;Increment on string instructions 
push ax 7;Store all changed registers on the 
push bx 7stack 
push di 7In this case the sequence 
push si 7must be observed ! 
push bx ;These three registers are returned 
push cx ;from the stack before the end 
push dx 7of the routine 
sub dh,bh ;Calculate the number of the column 
inc dh 
mov al,bl 7;Record line upper left in AL 
mov bl,dl ;Line upper right to line upper left 
call calo ;Convert upper left into offset 
mov si,di ;Record address in SI 
sub bl,cl ;Deduct number of lines to scroll 
call calo sConvert upper left in offset 
xchg si,di 7Exchange SI and DI 
sub dl,al ;Calculate number of lines 
inc dl ;Deduct number 
sub dl,cl 7of lines to be scrolled 
push ds ;Push segment register onto stack 
push es 
mov ax,VIO SEG 7;Segment address of video RAM 
mov dsS,ax ;to DS 
mov eS,ax ;and ES 
sdnl: mov ax,di ;Move DI to AX 
mov bx,si ;Move SI to BX 
mov cl,dh ;Number column in counter 
rep movsw 7Scroll one line 
mov di,ax 7Get DI from AX 
mov si,bx ;Restore SI from BX 
sub di,160 7;Set next line 
sub si,160 
dec dl 7All lines processed ? 
jne_ sdnil 7NO --> scroll another line 
pop es 7Get segment register from 
pop ds ;stack 
pop dx ;Return lower right corner 
pop cx ;Return number of lines 
pop bx ;Return upper left corner 
mov dl,bl 7Upper line to DL 
add dl,cl zAdd number of lines 
dec dl 
mov ah,0O7h 7Color : black on white 
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call clear 


PC System Programming 


;Erase lines which were released 


pop si 7;CX and DX are 
pop di 7; already returned 
pop bx 
pop ax 
ret 7;Back to caller 
scrolldn endp 
-- CLS: Clear the complete screen ------------------------------- 


=e Ne We Re 
it 
tt 


register : 


cls proc 
mov 
xor 
MOV 
7 
cls endp 


“ec “Ne Se “Ne “ae “Sao Ne Ne 


register : 
clear proc 


cld 
push 
push 
push 
push 
push 
sub 
inc 
sub 
inc 
call 
mov 
mov 
xor 
mov 
clearl: mov 
mov 
rep 
mov 


pop 
ret 


clear endp 


Input : AH = 


Input : none 
Output : none 


only FLAGS are changed 


near 


ah, 07h 
bx, bx 
dx, 4F18h 


Execute Clear 


7;Color is white on black 
7Upper left is (0/0) 
;Lower right is (79/24) 


SP Se AD AS CO I NS ND OU CONE NY GES GLEE GP UE SD EE SEE SNE GO SEY VD SL AND I CY OES NE OA SEE GLAD SOD GOED OD SLED GED NS GD GUN GEN sme cD 


CLEAR: fills a designated display with space characters ---- 
Attribute/color 


BL = line upper left 


BH 
DL 
DH 


tl 


Output : none 


column upper left 
line lower right 
column lower right 


only FLAGS are changed 


near 


cx 
dx 

si 

di 

es 

dl,bl 

dl 

dh, bh 

dh 

calo 

cx, VIO_SEG 
es, CX 

ch, ch 

al, eo 
si,di 
cl,dh 


clearl 


es 
di 
si 
dx 
cx 


;Increment on string instructions 
7;Store all registes which 
yare changed on the stack 


;Calculate number of lines 
;Calculate number of columns 


;Offset address of upper left corner 
;Segment address of the video RAM 
;to ES 

;Hi-bytes of the counter to 0 
;Space character 

;Move DI to SI 

;Number of column in counter 
;Store space character 

;Restore DI from SI 

sSet in next line 

7;All lines processed ? 

7NO --> erase another line 


;Restore registers from 
;stack 


;Back to caller 


7~-- PRINT: outputs a string on the Display ------------~------- 
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-- Input : AH = Attribute/color 
-— DI = offset address of the first character 
—_ SI = offset address of the string to DS 


=a “Ms “Me Ve We Ve VWs 


-- Output : DI points behind the last character output 
-- register : AL, DI and FLAGS are changed 
-- Info : the string must be terminated with a NUL-character. 
- other control characters are not recognized 
print proc near 
cld ;Increment on string instructions 
push si 7Store SI, DX and ES on the stack 
push es 
push dx 
mov dx,VIO_ SEG ;Segment address of the video RAM 
mov es,dx 7First to DX and then to ES 
jmp printi 7YES --> Output finished 
printo: stosw ;Store attribute and color in V-RAM 
printi: lodsb 7Get next character from the string 
or al,al 7Is it NUL 
jne printo 7NO --> output 
printe: pop dx 7;Get SI, DX and ES back from stack 
pop es 
pop si 
ret ;Back to caller 
print endp 


7- CALO: converts line and column into offset address ---------------- 
7-~ Input : BL = line 

i-- BH = column 

7-- Output : DI the offset address 

7-- Registers: DI and FLAGS are changed 


calo proc near 
push ax 7Store AX on the stack 
push bx 7Store BX on the stack 
shl bx,1l ;Column and line times 2 
mov al,bh 7Column to AL 
xor  bh,bh ;Get Hi-byte 
mov di, {linent+bx] ;Offset address of the line 
xor ah,ah 7HI-byte for column offset 
add di,ax ;Add line- and column offset 
pop bx ;Get BX from stack again 
pop ax ;Get AX from stack again 
ret 7;Back to caller 

calo endp 

code ends 7End of the CODE segment 
end demo ;Start program execution w/ demo 
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10.3 The Hercules Graphic Card 


The Hercules display adapter displays text in both text mode and graphics mode, 
with a graphic resolution of 720x348 pixels. This card contains enough RAM for 
two display pages. Each display page is 32K, so video RAM can accept a 4K text 
page and a graphic page. The first display page extends from address B000:0000 to 
B000:7FFF. The second screen page goes from B000:8000 to BO00:FFFF. 


Hercules video RAM 
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The Hercules card's video RAM in text mode has the same cursor character and port 
addresses as the IBM monochrome display adapter. With the graphic capabilities, 
only a few bits in the status and control register are different from the monochrome 
card. An additional configuration register can be addressed from 3BFH. You can 
write to this register only. Only bits 0 and 1 are of interest to the programmer. 
The former indicates whether the graphic mode can be switched on (1) or not (0). 
Bit 1 determines whether the second display page can be used. Bit 1 contains the 
value 1 if the second page is usable. 


To avoid conflicts with other video cards (especially color cards), both bits are set 
to 0 at the start of the system so that n¢ither graphic mode nor the second display 
page are accessible at first. Application programs must configure the Hercules 
display adapter through the configuration register if the programs require graphic 
mode or the second screen page. 


The control register of the Hercules graphic card has some differences from that of 
the MDA discussed in the preceding section. 


=text mode 
1=graphic mode 


O=screen off 
1=screen on 


O=blinking disabled 
1=blinking enabled 


O=display screen 
page 1 


1=display screen 
page 2 


The Hercules control register (3B8H) 
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Unlike the IBM monochrome display adapter, bit 0 is unused and doesn't have to 
be set to 1 during the system boot. Bit 1 determines text or graphic mode: a 0 in 
bit 1 enables text mode, while a 1 in bit 1 enables graphic mode. As you shall see 
in the following examples, changing these bits isn't enough to switch between 
text and graphic modes. The internal registers of the 6845 must be reset as well. 
During this process, the screen display must be switched off to prevent the 6845 
from creating garbage during its reprogramming. 


The Hercules card has a seventh bit in this register. Its contents determine which of 
the two screen pages appear on the monitor screen. If this bit is 0, the first screen 
page appears; a 1 calls the second screen page on the screen. Independent of each 
other, the user can write to or read from either page at any time. You can only 
write to this register; attempts to read this register return the value FFH. Because 
of this, it is impossible to switch off the display simply by reading the contents of 
the status register and erasing bit 3, regardless of the display mode and the screen 
page selected. 


“ Horizontal 
synchronization 
signal: O=off, 1=on 


0=Current pixel off — | 
1=Current pixel on | 
Vertical 


synchronization 
signal: O=on, 1=off 


Hercules status register (3BAH) 


Only the significance of bit 7 makes this register different from the IBM 
monochrome card. It's always set to 0 when the 6845 sends a vertical 
synchronization signal to the display. This signal is always sent when the last 
screen line has been constructed. The electron beam, which constructs the display, 
then jumps to the first line of the'screen to start constructing a new screen. 


Since the Hercules card uses the same processor as the IBM card, the internal 
registers of the 6845 and their meaning are identical to the IBM card. The index 
register and data register are also located at the same address. The following values 
must be assigned to the various registers in the text and graphic modes 
respectively: 
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line of blinking cursor 
Ending line of the blinking cursors 
High byte of screen page starting address 
ow byte of screen page starting address 


Re 
Re 


As mentioned earlier, the Hercules card in graphic mode provides 348x720 
resolution. Every pixel on the screen corresponds to one bit in the video RAM. If 
the corresponding bit contains the value 1, the dot is visible on the display, 
otherwise it remains dark. The following figure shows the construction of the 
video RAM in the graphic mode. 
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+0000 (h) | Line 0 (90 bytes) 
+005A(h) | Line 4 (90 bytes) 
+00B4(h) [ Line 8 (90 bytes) | ' 
+1D88 (h) J Line 336 (90 bytes) 


+1DE2 (h) | Line 340 (90 bytes) 


+1E3C (h) § Line 344 (90 bytes) 
+1E96(h) J unused (362 bytes) 


+2000 (h) 


Line 1 (90 bytes) 


RAM 


+205A (h) [| Line 5 (90 bytes) 
+20B4 (h) | Line 9 (90 bytes) 
+3088 (h) Line 337 (90 bytes) 
+3DE2 (h) | Line 341 (90 bytes) 
+3E3C (h) | Line 345 (90 bytes) 
+3E96 (h) | unused (362 bytes) 
+4000 (h) | Line 2 (90 bytes) 
+405A (h) | Line 6 (90 bytes) 
+5DE2 (h) J Line 342 (90 bytes) 
+5E3C (th) | Line 346 (90 bytes) 


+5E96 (h) 
+6000 (h) 
+605A (h) 
+60B4 (h) 


unused (362 bytes) 
Line 3 (90 bytes) 


Line 7 (90 bytes) 
Line 11 (90 bytes) 


+7D88 (h) | Line 339 (90 bytes) 
+7DE2 (h) | Line 343 (90 bytes) | 
+7E3C (h) | Line 347 (90 bytes) 


+7E96(h) | unused (362 bytes) 
+8000 (h) 


Video RAM and the screen under construction 


The bit patterns of the individual lines in the video RAM aren't arranged 
sequentially, as you might have assumed. The 32K of video RAM is divided into 
four 8K blocks. The first block contains the bit pattern for any lines divisible by 4 
(0, 4, 8, 12, etc.). The second block contains the bit patterns for lines 1, 5, 9, 13 
etc. The third block contains the bit patterns for lines 2, 6, 10, 14, etc., while the 
last block contains lines 3, 7, 11, 15 etc. When the 6845 generates a display, it 
obtains information for screen line zero from the first data block, screen line one 
from the second data block, etc. After it has obtained the contents of the third 
screen line from the fourth data block, it accesses the first data block again for the 
structure of the fourth line. Each line requires 90 bytes within the individual data 
blocks—every pixel requires a bit, and 720 pixels divided by 8 bits (per byte) 
equals 90. The first 90 bytes in the first memory area provide the bit pattern for 
screen line zero, and the 90 bytes following provide the bit pattern for the fourth 
screen line. The zero byte of one of these 90-byte sets represents the first eight 
columns of a screen line (columns 0-8). The first byte represents columns 8-15, 
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etc. Within one of these bytes, bit 7 corresponds to the left screen pixel and bit 0 
corresponds to the right screen pixel. 


RAM 


0000:0000 


7654 32 1 0 bit 


Column 012345 67 COMM: TZ: tecescscciceccicresttncrtiiotss 


Relationship between 90-line bytes and screen display 


If the screen pixels of a line (0 to 719) and the screen pixels of a column (0 to 
347) are sequentially numbered, an equation indicates the address of the bytes 
relative to the beginning of the screen page. This address contains the information 
for a pixel with the coordinates X/Y. 


To determine the bit within the byte which represents the pixel, the following 
formula can be used: 


Address = 2000H * (Y mod 4) + 90 * int(Y/4) + int (X/8) 


The following program demonstrates the abilities of the Hercules display adapter. 
The individual routines within this program have some differences from the 
routines shown in the monochrome display adapter demo program from the 
previous section. The routines here enable access to both screen pages, and support 
the Hercules graphic mode. 


Assembler listing; VHERC.ASM 
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KEKE KKKEKKKKKE EEK KEK KEKEKKERKEKK KEKE EKER EKER KEK KEKE KEKREKKEKEREKRKEKEKEKKKKEK © 


tf 

;* VHERC *; 
3* a as 0 eam Ek as ae ee wee Os Oe OR Oe Ow ED ED am ant Ob REED ED An ED eb REED ED DED an aves En aban anenan cman on eben an nan an anon or an an an awe an amen em eman om “3 
ee Task : makes a basic function available for x3 
tod access to the HERCULES GRAPHICS CARD =F 
ries em ce sees tin ea da cies ces co sb: cb cs asset ims sch wn mes es es em sn elec ech sw meas cm ams cml com come cease cas cs Ss Nm ai i ns eis “am tein mcm esses es es nas ee tices ts cae xs 
7* Info : all functions partition the screen display x 
Eas into columns 0-79 and lines 0-24 (text mode) *; 
7 & columns 0-719 and lines 0-347 (graphic mode) *; ‘ 
rae <i iis i'w ie oh: ee Sie i a Sm si Sh a AS wai es sisi i ls a: Ge cep ei xe ce a ee el sein se a sai ne i eg es one ssl See: ei as ei ei a: xs 
7* Author : MICHAEL TISCHER *; 
a developed on : 8/11/87 +; 
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ial last update : 6/15/89 es 
a* ccm os ac em sees Sins ei lin hia eum n'a ins sas vue cui ss ‘inca Gen enum cians st man Se hs nh ems esi a i Ses GS cs Seis i es ets ns sah en ci Sw ein in Ss sat es i SS a: 
ihe assembly : MASM VHERC; ¥e 
aa LINK VHERC; te 
:* lm ps es ch i eis ts Ins a ci i ii es i ise ss cen ec as it io Se ses oe i Uh om i ie ial ea i Wh si sd a i a. ws 
z* call : VHERC wy 
PARA RRKERKRER ERK IKKE EERE KER E KKK ERE REE KERR KEKE RR EEK KEKE EK KS 


-”~ 


CONTROL REG = 03B8h ;Control register port address 
ADDRESS_6845 = 03B4h 76845 address register 

DATA 6845 = O3B5h 7684S data register 

CONFIG REG = O3BFh ;Configuration register 

VIO_SEG = OBOO00Oh 7Video RAM segment address 
CUR_START = 10 ;Reg. # for CRTC: Start cursor line 
CUR END = 11 7Reg. # for CRTC: End cursor line 


CRTC: 
CRTC: 


CURPOS HI = 14 Cursor pos hi byte 


Cursor pos lo byte 


7Reg. # for 


CURPOS LO) == 15 


DELAY 


;== Macros 


setmode macro modus 7Set control register 
mov dx,CONTROL REG 2Screen control register address 
mov al,modus 7;Put new mode in AL register 
out dx,al 7;Send mode to control register 
endm 
setvk macro ;Write value to CRTC registers 
zInput: AL = register number 
; AH = Value for register 
mov dx,ADDRESS_ 6845 ;Index register address 
out dx,ax ;Display register number and new value 
endm 
stack segment para stack ;Definition of stack segment 
dw 256 dup (?) 7;Stack is 256 words in size 
stack ends 7End of stack segment 
data segment para 'DATA' 7;Define data segment 
initm db 13,10,"VHERC (c) 1987 by Michael Tischer",13,10,13,10 
db "This demonstration program runs only with " 
db “ a HERCULES",13,10,"“graphics card. If your PC " 
db “has another type of display card, ",13,10 
db "please input an >s< to stop the " 
db " program.",13,10,"“Otherwise please press any " 
db "key to start the ",13,10 
db “program ..."“,13,10, "S$" 
strl db 1,17,16,2,7,0 
str2 db 2,16,17,1,7,0 
domes db 13,10 
db "This program creates a short graphic demo ",13,10 
db “and a text demo. Pressing a key during the",13,10 


| 
NO 
Oo 
oO 
Oo 
io) 


7Reg. # for 


;Count for delay loop 


SSS SSS SSS 5S 5. 5S 0S SE SLE Ll LSS_ SS SS LS SS SS SS LS SS SS SS LS SS SS SS eS SS 
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db “demo ends the program.",13,10 
db “Press a key to start the program...",13,10,"S* 
7== Table of line offset addresses ======«=e==s==2=s22ssses==s=== 


lines dw 0*160,1*160,2*160 ;Beginning addresses of the lines as 
dw 3*160,4*160,5*160 ;offset addresses in video RAM 
dw 6%*160, 7*160, 8*160 
aw 9*160,10*160,11*160, 12*160,13*160, 14*160,15*160, 16*160 
dw 17*160,18*160, 19*160, 20*160, 21*160, 22*160, 23*160, 24*160 


grafikt db 35h, 2Dh, 2Eh, O7h, SBh, 02h ;Register values for the 
db 57h, 57h, 02h, O3h, OOh, OOh ;graphic mode 


textt db 61h, 50h, 52h, OFh, 19h, 06h ;Register values for the 
db 19h, 19h, 02h, ODh, OBh, Och ;text mode 

data ends 7End of data segment 

7== Code segment ==s===s===s=es==s=ssssssss===sSsss=sssrs=== 

code segment para 'CODE' ;Definition of the code segment 
org 100h 


assume cs:code, ds:data, es:data, ss:stack 


demo proc far 
mov ax,data 7Get segment address of data segment 
mov ds,ax ;Load into DS 
mov eS,ax zand ES 
7~~- Opening msg., wait for input -------------------- 
mov ah, 9 ;Output function number for string 
mov dx,offset initm gaddress of the message 
int 21h 7Call DOS interrupt 
xor ah,ah 7;Get function number for key 
int 16h 7Call BIOS keyboard interrupt 
cmp al,"s" ;Was <s> entered? 
je ende 7YES--> End program 
cmp al,“S" ;Was <S> entered? 
jne startdemo 7NO --> Start demo 
ende: mov ax, 4C00h 7Function number - end program 
int 21h 7Call DOS interrupt 21H 
startdemo label near 
mov ah,9 7Output function number for string 
mov dx,offset domes j;address of the message 
int 21h 7Call DOS interrupt 
xor ah,ah 7Get function number for key 
int 16h 7Call BIOS keyboard interrupt 


z-~ Initialize graphic mode ---------~------~----------- 


mov al,11b ;Graphic and page 2 possible 
call config ;Configure 

xor bp,bp ;Access display page 0 

call grafik 7Switch to graphic mode 

xor al,al 

call cgr ;Erase graphic page 0 

xor bx, bx 7;Begin in the upper left 
xor dx,dx 7;Display corner 

mov ax, 347 7;Vertical pixels 
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mov cx,719 ;Horizontal pixels 
gril: push cx -Push horizontal pixels on stack 

MOV CX,ax 7Vertical pixels in counter 

push ax 7;Push vertical pixels on stack 
gr2: call spix 7;Set pixel 

inc dx s;Increment line 

loop gr2 ;Draw line 

pop ax 7Get vert. pixels from stack 

sub ax,3 ynext line 3 pixels less 

pop cx 7;Get horiz. pixels from stack 

push cx 7Store horizontal pixels 

push ax 7Push vertical pixels on stack 
gr3: call spix 7set pixel 

inc bx ;Increment column 

loop gr3 7;Draw line 

pop ax 7Get vertical pixels from stack 

pop cx 7Get horizontal pixels from stack 

sub cx, 6 7;Next line 6 pixels less 

push cx 7Record horizontal pixels 

MOV CX,ax ;Vertical pixels in counter 

push ax ;Note vertical pixels on stack 
gr4: call spix 7Set pixel 

dec dx ;Decrement line 

loop gr4 ;Draw line 

pop ax 7;Get vertical pixels from stack 

sub ax,3 7Next line 3 pixels less 

pop cx 7Get horizontal pixels from stack 

push cx ;Record horizontal pixels 

push ax ;Record vertical pixels on stack 
grs: call spix 7Set pixel 

dec bx ;Increment column 

loop gr5 7Draw line 

pop ax 7;Get vertical pixels from stack 

pop cx 7;Get horizontal pixels from stack 

sub cx, 6 7Next line 6 pixels less 

cmp ax,5 ;Is the vertical line longer than 5 

ja grl 7YES --> continue 

xor ah,ah sWait for function nr. for key 

int 16h 7Call BIOS keyboard interrupt 


e-> Initlalize. text: mode ==<=<-=—--4+=-$s-q55------5 = 


call text 7;Switch on text mode 
mov cx,0d00h 7;Switch on full cursor 
call cdef 

call cls 7;Clear screen 


7-- Display strings in display page 0 ------------------ 


xor bx,bx ;Start in upper left display corner 
call calo 7;Convert to offset address 
mov si,offset strl 7;Offset address of stringl 
mov cx,16*25 7The string is 5 characters long 
demol1: call print 7Output string 
loop demol 
;-- Display strings in display page 1 ------------------ 
inc bp 7;Process display page 1 
xor bx,bx ;Start in the upper left corner 
call calo ;Convert to offset address 
mov si,offset str2 7Offset address of stringl 
mov cx,16*25 ;string is 5 characters long 
demo2: call print ;Output string 
loop demo2 
demo3: setmode 10001000b ;Display text page 1 
f-~ Short PauSe@ ---- nn rn rn rn nr 
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mov cx, DELAY ;Load counter 

pause: loop pause 7Count to 65,536 
setmode 00001000b ;Display page 0 
g-~- Short PauS@ -- nen nen nn rr nn rn rn nnn 
mov cx, DELAY ;Load counter 

pausel: loop pausel 7;Count to 65,536 
mov ah,l ;Test function nr. for key 
int 16h ;Call BIOS-keyboard-Interrupt 
je  demo3 ;No key --> continue 
xor ah,ah 7Get function number for key 
int 16h 7Call BIOS-keyboard-Interrupt 
mov bp,0O ;Display page 1 
call cls 7;Clear screen 
mov cx, O0DOch 7;Restore normal cursor 
call cdef 
call cls ;Clear screen 
jmp ende 7End program 

demo endp 

,2= The actual functions follow SSS SS SS LS SS SS LS LS LS LS LS SS SS SS Sl TS SS SS 


CONFIG: configures the HERCULES card -<---------- 3-3 rrr 
-- Input : AL : bit 0 = 0: Only text presentation possible 

also graphic presentation possible 

RAM for display page 2 off 

RAM for display page 2 on 


1 
=< bit 1 = 0 
1 


-- Output ¢; none 
Register : AX and DX are changed 


=e Se %se Na Ne Ve No 


config proc near 
mov dx,CONFIG REG ;Address of configuration register 
out dx,al 7;Set new value 
ret ;Back to caller 


config endp 


-- TEXT: switches the text presentation on ~-------------------------- 
Input : none 

-- Output : none 

-- Register : AX and DX are changed 


=e “ee Me Ne 


text proc near 
mov si,offset textt ;Offset address of the register-table 
mov b1,00100000b ;Display page 0,text mode, blinking 
jmp short vcprog ;Program video-controller again 
text endp 
~- GRAFIK: switches on the graphic mode ------- ----------~------------ 


-- Input : none 
-- Output =: none 
Register : AX and DX are changed 


=e “es Ne Vs 


grafik proc near 


mov si,offset grafikt ;Offset address of the register-table 
mov b1,00000010b ;Display page 0, graphic mode 


grafik endp 


7—-~ VCPROG: programs the video controller ------------------ 73 - = -- 
7-- Input : SI = address of a register-table 
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poz BL = value for display-control-register 
77—~ Output none 
;-- register : A=, SI, BH, DX and FLAGS are changed 


veprog proc near 
setmode bl 7;Bit 3 = O: display aus 
mov cx,12 312 registers are set 
xor bh,bh 7;Start with register 0 
vepl: lodsb 7;Get register value from the table 
mov ah,al 7Register value to AH 
mov al,bh zNumber of the register to AL 
setvk 7Transmit value to the controller 
inc bh ;Address next register 
loop vcpl 7;Set additional registers 
or bl,8 7Bit 3 = 1: display on 
setmode bl 7;Set new mode 
ret 7;Back to caller 


vcprog endp 


cCDEF: sets the start and end line of the cursor-<------------------- 


, 
7-- Input : cL = start line 
j-- cH = end line 
r7— Output : none 
7-- register : AX and DX are changed 
cdef proc near 
mov al,CUR_START 7Register 10: start line 
mov ah,cl 7Start line to AH 
setvk ;Transmit to video-controller 
mov al,CUR_END 7;Register 11: Endline 
mov ah,ch ;End line to AH 
setvk 7Transmit to video-controller 
ret 
cdef endp 


7;-- SETBLINK : sets the blinking display cursor ----------------------- 
z-- Input : DI = offset address of the cursor 

777 Output : none 

7-- register : BX, AX and DX are changed 


setblink proc near 


mov bx,di ;Transmit offset to BX 

mov al,CURPOS HI ;Register 15:Hi Byte of cursor offset 
mov ah,bh 7HI byte of the offset 

setvk ;Transmit to video-controller 

mov al,CURPOS LO ;Register 15:Lo-Byte of cursor offset 
mov ah,bl 7Lo byte of the offset 

set vk 7;Transmit to CRTC 

ret 


setblink endp 


GETVK : reads a byte from one register of the video-controller - 
-- Input : AL = number of the register 

Output : AL = content of the register 
register : DX and AL are changed 


“se Se Ns Me 
J 
i 


getvk proc near 


mov dx,ADDRESS 6845 ;Address of the index register 


out dx,al ;Send number of the register 
jmp $+2 7;Short io pause 
inc dx ;Address of the index register 
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in al, dx p;Read content to AL 
ret 7;Back to caller 
getvk endp 


-- SCROLLUp: scrolls a window by N lines upward ----<-------<--------~ 
Input : BL = line upper left 

-- BH = column upper left r 

-- DL = line lower right 

-- DH = column lower right 

-— CL = number of the lines to be scrolled 

BP = number of the display page (0 or 1) 


Be Be Be Ve VWs Re MWe We Be Vo 


-- Output s none 
-- register : only FLAGS are changed 
-- Info : the display lines released are erased 


scrollup proc near 


cld ;Increment for string instructions 
push ax 7Store all changed registers 
push bx 7on the stack 
push di zIn this case the sequence 
push si 7;must be followed ! 
push bx ;These three registers are returned 
push cx ;from the stack before 
push dx ;the end of the routine 
sub dl,bl ;Calculate number of lines 
inc dl 7Deduct number 
sub dl,cl ;of lines to be scrolled 
sub dh,bh 7;Calculate number of columns 
inc dh 
call calo ;Convert upper left in offset 
mov si,di ;Note address in SI 
add bli,cl ;First line in scrolled window 
call calo ;Convert first line in offset 
xchg si,di 7Exchange SI and DI 
push ds _ gStore segment register 
push es zon the stack 
mov ax,VIO SEG ;Segment address of the video RAM 
mov ds,ax sto DS 
mov eS,ax z;and ES 
supl: mov ax,di ;Note DI in AX 
mov bx,si ;Note SI in BX 
mov cl,dh ;Number of columns in counter 
rep movsw ;Move a line 
mov di,ax 7;Restore DI from AX 
mov si, bx ;Restore SI from BX 
add di,160 7;Set next line 
add si,160 
dec dl ;Processed all lines ? 
jne supl 7;NO --> move another line 
pop es ;Get segment register from 
pop ds 7 stack 
pop dx 7Get lower right corner 
pop cx ;Get number of lines 
pop bx 7Get upper left corner 
mov bl,dl_. ;Lower line to BL 
sub bl,cl 7Deduct number of lines 
inc bl 
mov ah,0O7h 7Color : black on white 
call clear ;Erase liberated lines 
pop si 7CX and DX have been brought back 
pop di ;already 
pop bx 
pop ax 
ret ;7;Back to caller 
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scrollup endp 


-- SCROLLDN: scroll a Window by N lines upwards ---------------------- 
BL = line upper left 

BH = column upper left 

DL = line lower right 

DH = column lower right 

CL = number of the lines to be scrolled 

BP = number of the display page (0 or 1) 


only FLAGS are changed 
released lines are deleted 


r7- Input : 

7 awe 

Py om 

ie : 

7-—- Output : none 

7-- register : 

j-- Info : 

scrolldn proc near 
cld 
push ax 
push bx 
push di 
push si 
push bx 
push cx 
push dx 
sub dh,bh 
inc dh 
mov al,bl 
mov bl,dl 
call calo 
mov si,di 
sub bl,cl 
call calo 
xchg si,di 
sub dl,al 
inc dl 
sub dl,cl 
push ds 
push es 
mov ax,VIO SEG 
mov ds,ax 
mov es,ax 

sdnl: mov ax,di 
mov bx,si 
mov cl,dh 
rep movsw 
mov di,ax 
mov si,bx 
sub di,160 
sub si,160 
dec dl 
jne  sdnl 
pop es 
pop ds 
pop dx 
pop cx 
pop bx 
mov dli,bl 
add dl,cl 
dec dl 
mov ah,0O7h 
call clear 
pop si 
pop di 
pop bx 
pop ax 
ret 


;Increment on string instructions 


;Secure all changed registers on the 
;stack 

yin this case the sequence must 

zbe followed! 


;These three registers are 
;returned from the stack before the 
zend of the routine 


7;Calculate number of columns 


;Record line upper left in AL 
;Line lower right top lower left 
;Convert upper left in offset 
;Note address in SI 

;Deduct number of chars to scroll 
;Convert upper left in offset 
7Exchange SI and DI 

;Calculate number of lines 


;Deduct number of lines to scroll 
;Store segment register on the 
;stack 

;Segment address of the video RAM 
sto DS 

z;and ES 

;Record DI in AX 

;Record SI in BX 

sNumber of columns in counter 
s;Move a line 

;Restore DI from AX 

;Restore SI from BX 

7;Set next line 


7All lines processed ? 

7;NO --> move another line 
7;Get segment register from 
;stack 

7Get lower right corner 
7;Get number of lines 

7Get upper left corner 
;Upper line to DL 

7;Add number of lines 


;Color : black on white 
;Erase liberated lines 


7CX and DX have already 
;been read 


;Back to caller 
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scrolldn endp 


-~- cLS: clear the whole SCLeE@N -- remem rn rn rrr rr nnn nnn 
Input : BP = number of the display page (0 or 1) 
Output : none 


=e Ss Se Be 


-~- register : only FLAGS are changed 
cls proc near 
mov ah,O7h 7Color is white on black 
xor bx,bx ;Upper left is (0/0) 
mov dx, 4F18h zLower right is (79/24) 
e-~ perform Cl@aYl qn nnn nn rn rrr 
cls endp 
77~ CLEAR: fills a designated display area with space character ------- 
7-- Input : AH = Attribute/color 
;—- BL = line upper left 
77 BH = column upper left 
7-- DL = line lower right 
i-- DH = column lower right 
i-~ BP = number of the display page (0 or 1) 
7-~ Output : none 
;~- register : only FLAGS are changed 
clear proc near 
cld zIncrement on string instructions 
push cx 7Secure all changed 
push dx ;registers on the stack 
push si 
push di 
push es 
sub dl,bl ;Calculate number of lines 
inc dl 
sub dh,bh 7;Calculate number of columns 
inc dh 
call calo ;Offset address of upper left corner 
mov cx,VIO_SEG 7;Segment address of the video RAM 
mov eS, Cx z;to ES 
xor ch,ch ;Hi byte of the counter to 0 
mov al,“ * ;Space character 
clearl: mov si,di ;Note DI in SI 
mov cl,dh 7Number of columns in counter 
rep stosw 7;Store space character 
mov di,si 7;Restore DI from SI 
add di,160 7Set next line 
dec dl 7All lines processed ? 
jne clearl 7;NO --> erase another line 
pop es 7Get secured registers 
pop di 7;from the stack 
pop si 
pop dx 
pop cx 
ret 7;Back to caller 
clear endp 


7-~ PRINT: outputs a string on the display ---~------------~------------ 


7-- Input : AH = attribute/color 
7 DI = offset address of the first character 
-— SI = offset address of the strings to DS 


e 
i-- BP = number of the display page (0 or 1) 

7-— Output DI points behind the last character to be output 
7-- register : AL, DI and FLAGS are changed 

j-- Info the string must ne terminated with NUL-character. 
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print proc near 

cld 

push si 

push es 

push dx 

mov dx,VIO_ SEG 

mov es,dx 

jmp printl 
printo: stosw 
printl: Lodsb 

or al,al 

jne printo 
printe: pop dx 

pop es 

pop si 

ret 
print endp 
7-- cCALO: 
z7~ Input : BL = line 
ies BH = column 
.o Bp = 
7-- Output : DI = offset address 
;-- register : 
calo proc near 

push ax 

push bx 

shl bx,1 

mov al,bh 

xor bh,bh 

mov di, [lines+bx] 

xor ah,ah 

add di,ax 

or bp, bp 

je caloe 

add di,8000h 
caloe: pop bx 

pop ax 

ret 
calo endp 


-- Input 


-- Output 
regist 


“=e "ss Se Re Me Ve 
! 
! 


2 
Q 
6 
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other control characters are not recognized 


;Increment on string instructions 
7SI, DX and ES to the stack 


7First segment address of video RAM 
z;to DX and then to ES 

sGet first character from string 
7Store attribute and color in V-RAM 
7;Get next character from tne string 
zIs it NUL 

7NO --> output 


7Get SI, DX and ES from stack again 


;Back to caller 


converts line and column into offset address ---------------- 


CGR: clear 


er 
proc 


push 
cow 
xor 
MOV 
or 


je 


add 


number of the display page (0 or 1) 


DI and FLAGS are changed 


;Record AX on the stack 
;Record BX on the stack 


;Column and line times 2 
7Column to AL 

;Hi byte 

7Get offset address of the line 
7;Hi byte for column offset 

;Add lines- and column offset 
7;Display page 0? 

7;YES --> address ok 


;Add 32 KB for display page 1 
7Get BX from stack again 


7Get AX from the stack again 
7;Back to caller 


the -complete graphic screen ---S-+=--S49-<- S535 
BP = number of the display page (0 or 1) 
AL = OOH : erase all pixels 

FFH : set all pixels 


none 


AH, BX, cX, DI and FLAGS are changed 


near 
es 


di,di 

bx, VIO_SEG 
bp, bp 

egrl 


bx, 0800h 


7;Record ES on the stack 

7Expand AL to AH 

;Offset address in video RAM 
7;Segment address display page 0 
7Erase page 1? 

7;NO --> erase page 0 


7Segment address display page 1 
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cgrl: mov es, bx 7;Segment address to segment register 
mov cx, 4000h 7A page is 16K-words 
rep stosw 7Fill page 
pop es 7;Get ES from stack 
ret ;Back to caller 
cgr endp 


SPIX: sets a pixel in the graphic display -------- 3 ee -n 
Input : BP = number of the display page (0 or 1) 

BX = column (0 to 719) 

DX = line (0 to 347) 


“Ms “Ne Be Ns Re VWs 
{ 
! 


-—- Output : none 
-- register : AX, DI and FLAGS are changed 
spix proc near 
push es 7;Store ES on the stack 
push bx ;Store BX on the stack 
push cx 7;Store cX on the stack 
push dx 7;Store DX on the stack 
xor di,di ;Offset address in video RAM 
mov cx,VIO_SEG ;Segment address display page 0 
or bp, bp 7;Access page 1 ? 
je spixl ;NO --> access page 0 
mov cx, 0800h :Segment address display page 1 
spixl: Mov eS,CX ;Segment address in segment register 
mov ax,dx ;Move line to AX 
shr ax,1 ;Shift line right 2 times 
shr ax,1 ;This divides by four 
mov cl, 90 ;The factor is 90 
mul cl ;Multiply line by 90 
and dx,1lb ;AND all bits except for 0 and 1 
mov cl,3 73 shifts 
ror dx,cl ;Rotate right (* 2000H) 
mov di,bx 7;Column to DI 
mov cl,3 73 shifts 
shr di,cl ;divide by 8 
add di,ax 7+ 90 * int (line/4) 
add di,dx 3+ 2000H * (line mod 4) 
mov cl,7 ;Maximum of 7 moves 
and bx,7 7;Column mod 8 
sub cl,bl 77 - column mod 8 
mov ah,1l sDetermine bit value of the pixels 
shl ah,cl 
mov al,es: [di] 7;Get 8 pixels 
or al,ah 7Set pixel 
mov es:{[di],al ;Write 8 pixels ; 
pop dx 7;Get DX from stack 
pop cx 7Get cX from stack 
pop bx 7;Get BX from stack 
pop es 7Get ES from stack 
ret ;Back to caller 
spix endp 
pe= End =ss==S=sssssessssssssssSssSseses sees Ss SSS SSS SSS Se SSS Sse ssesssSs= 
code ends 7;End of the code segment 
end demo 
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10.4 The IBM Color Card 


The IBM Color Card 


The IBM Color/Graphics Adapter (CGA) supports two text modes and three 
different graphic modes. Like the other two cards, the CGA is based on a 6845 
video processor and is equipped with 16K of video RAM which begins at address 
B800:0000. 


Text modes 


Besides the normal text mode of 25 lines and 80 columns, the CGA also has a text 
mode consisting of 25 lines and 40 columns. This 40-column mode displays 
characters twice as wide as normal 80-column mode. CGA characters are displayed 
in an 8x8 matrix, which results in a less distinct display than monochrome display 
adapter text. The CGA's video RAM assignment is almost identical to that of the 
monochrome card. The attribute byte is different from that of the monochrome 
display adapter. 


Character color 


Character intensity 
O=normal 
1=high intensity 


| Background color 
Blinking 

O-off 

1=0Nn 


Color/Graphics Adapter attribute byte 


The lower four bits of the attribute byte indicate one of the 16 available colors. 
The meanings of the upper four bits depend on whether blinking is active. If it is 
active, bits 4 to 6 indicate the background color (taken from one of the first eight 
colors of the color palette), while bit 7 determines whether or not the characters 
blink. If blinking is disabled, bits 4 to 7 indicate the background color (taken from 
one of the 16 available colors). 
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Black 

Blue 

Green 

Cyan 

Red 

Magenta 
‘Brown 

Light gray | 
Dark gray 
Light blue 
Light green 
Light cyan 
Light red 
Light magenta 
Yellow 
White 


bh bt bt pb . 
WHR OO AO YIHUBPWNHEHO 


jh 
a 
ymonNndWerWO WANA UMPWNHR OC 


MS 
ul 


Color/Graphics Adapter color palette 


Each 80x25 text page requires 4,000 bytes of video RAM. 16K allows a total of 
four text pages. The first display page starts at address B800:0000, the second at 


-B800:1000, the third at B800:2000 and the last at B800:3000. The 40x25 mode 


allows storage of eight display pages, because each display page only requires 
2,000 bytes in this mode. The first display page starts at address B800:0000, the 
second at B800:0800, the third at B800:1000, etc. 


Graphic modes 


The CGA supports three different graphic modes, of which only two are usually 
used. The color-suppressed mode displays 160x100 pixels with 16 colors. The 
6845 supports this resolution, but the rest of the hardware doesn't offer color- 
suppressed mode support. The remaining two graphic modes have resolutions of 
320x200 and 640x200 respectively. The 320x200 resolution permits four-color 
graphics, while 640x200 resolution only allows two colors. 


320x200 resolution 
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The CGA uses up all 16K of its video RAM for displaying a graphic in 320x200 
resolution with four colors. This limits the user to one graphic page at a time. Of 
the four colors permitted, the background can be selected from the 16 available 
colors. The other three colors originate from one of the two user-selected color 
palettes, which contain three colors each. 


10.4 The IBM Color Card 


Palette li Color 1: Cyan Palette 2: Color 1: Green 


Color 2: Violet Color 2: Red 
Color 3: White Color 3: Yellow 


Since a total of four colors are available, each screen pixel requires two bits. Four 
bits can represent the color numbers (0 to 3). The following values correspond to 
the various colors: 


0 00(b) = freely selectable background color 
1 01(b) = color 1 of the selected palette 
2 10(b) = color 2 of the selected palette 
3 11(b) = color 3 of the selected palette 


The video RAM assignment in this mode is similar to that of the Hercules card 
during graphic display. The individual graphic lines are stored in two different 
blocks of memory. The first block, which begins at address B800:0000, contains 
the even lines (0, 2, 4...); the second block, which begins at B800:2000, contains 
odd lines (1,3,5). 


Line 2 (80_ Bytes) fF 
Line 4 80 Bytes) F& 


DODO OOOOOOOODOOO 


Line 196 (80 Bytes) ; 
he 2 RAVE P ate 
a0! :. 


AQ SE SOS 
ae ee 
“4 Line 1 (80 B tes) = on AAR SSS 
Line 3 (80 Bytes) 


$ 
33 <e 


SRS 


Video RAM assignment in graphic mode (blocking) 


Each graphic line within the two blocks requires 80 bytes, since the 320 pixels in 
a line are coded into four pixels to a byte. The first byte in a graphic line (an 80- 
byte series) corresponds to the first four dots of the graphic on the screen. Bits 7 
and 8 contain the color information for the leftmost pixel, while bits 0 and 1 
contain the color information for the rightmost pixel of the byte. 
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500 


0000:0000 


bit 7654 3210 bit 7654 3210 


HE HEHE 


Column 0 Column 316 317 318 319 


Graphic line coding in 320x200 resolution 


A formula can be derived with the help of this information to determine the byte in 
video RAM, similar to the Hercules card. This byte is relative to the starting 
address of the screen page, which contains the color information for a pixel. The 
screen column (O—319) is designated as X and the screen line (0O—199) as Y: 


Address = 2000H * (Y mod 2) + 80 * int(Y/2) + int(X/4) 


To determine the number of the two bits within this byte which represents the 
pixel, use the following formula: 


Bit number = 6 - 2 * (X mod 4) 


For example, if this formula returns 4, this means that the color information for 
the dot is coded into bits 4 and 5. 
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0000:0000 


bit 7654 32 1 


Column 01234567 


Graphic line coding in 640x200 resolution 
640x200 resolution 


High-resolution mode with a resolution of 640x200 dots only allows the use of 
two colors. The video RAM assignment in this mode is similar to 320x200 mode. 
Each line displays twice as many pixels, with one bit encoding the line instead of 
2 bits. Because of this, one screen line requires 880 bytes. Therefore the formulas 
for access to a screen pixel are similar. 


Address = 2000H * (Y mod 2) + 80 * int(Y/2) + int (X/8) 
Bit number = 7 - (X mod 8) 
CGA registers 


The CGA has a mode selection register at address 3D8H which is comparable with 
the control register of the monochrome display adapter. You can write to this 
register but not read it. 
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0 


7 6 5S 4 3 2 121 bit _ | 
Pty dy dt yd. 0=40x25 characters 
1=80x25 characters 


O=text mode 


1=graphic mode (320x200) 
_|0=color display 
|j=monochrome display _ 
|O=screen off 


O=bright background 
1=blinking background 


Mode selection register 


Bit layout 


502 


Bit 0 of this register determines the text mode display of 80 or 40 columns per 
line. A 1 in bit 0 displays 80 columns, while a 0 in bit 0 displays 40 columns. 


The status of bit 1 switches the CGA from text mode to the 320x200 bit-mapped 
graphic mode. A 1 in this register selects graphic mode, while a 0 selects text 
mode. 


Bit 2 should be of interest to any users who want to operate their CGA with a 
monochrome monitor. If this bit contains the value 1, the 6845 suppresses the 
color signal, displaying monochrome mode only. 


Bit 3 is responsible for creating screens. If it contains the value 0, the screen 
remains black. This suppression is useful when changing between display modes; 
it prevents sudden signals from reaching the monitor which could cause damage. 


Bit 4 enables and disables 640x200 bitmapped graphic mode. A 1 in bit 4 enables 
this mode, while a 0 disables it. 


Bit 5 has the same significance as in the monochrome card. If it contains a 0, 
blinking stops and bit 7 returns one of the 16 available background colors. This 
bit contains a default value of 1, which causes blinking characters. 


The various text or graphic modes and the color or monochrome display can be 
selected in these modes with this register. Bits 0, 1, 2 and 4 are used for this. The 
following table shows how these bits must be programmed to obtain certain 
modes: 
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40x25 text color _| 


80x25 text monochrome 


80x25 text color 
320x200 graphic monochrome 


320x200 graphic color 
640x200 graphic monochrome 


The CGA also has a status register similar to the status register in the 
monochrome display adapter. The following figure shows the construction of this 
register, which can be found at address 3DAH. It is a read-only register. 


1=memory access possible 
without disturbing 
screen contents 


1=video access triggered 


O=video access on 
1=video access off | 


1=electronic signal 
transmitted in 
vertical direction 


Status register structure 


Bit 0 of this register always contains the value 1 when the 6845 sends a horizontal 
synchronization signal to the monitor. This signal is transmitted when the creation 
of a line ends and the CRT's electron beam reaches the end of the screen line. The 
electron beam then jumps back to the left corner of the screen line. The bit gets its 
significance from the condition that the CGA doesn't always allow data reading or 
writing within video RAM. 
Flickering and the CGA 

This problem occurs because the 6845 must continuously access video RAM to 
read its contents for screen display. If a program tries to transmit data to video 


RAM, problems can arise when the 6845 accesses video RAM at the same time. 
The result of this memory collision is an occasional flickering on the screen. 


To avoid this problem, you should only access video RAM when the 6845 is not 
accessing it. This only occurs when a horizontal synchronization signal travels to 
the screen, because it requires a moment of time until the electron beam has carried 


503 


10. Accessing and Programming the Video Cards PC System Programming 


out this instruction. For this reason, the status register must be read before every 
video RAM access on a CGA. This process must be repeated until bit 0 contains 
the value 1. When this happens, a maximum of two bytes can then be transmitted 
to video RAM. 


Demonstration program 


The program at the end of this section demonstrates how this process functions. 
This delay in video RAM access doesn't occur with monochrome cards because 
they are equipped with special hardware logic and fast RAM chips. This is also 
true of most of the newer model color cards. Before waiting for the horizontal 
synchronization signal, which results in an enormous delay of the display output, 
the user should try direct access to video RAM to test his color card's reaction 
time. 


If many accesses to video RAM occur within a short period of time (e.g., scrolling 
the screen), the electron beam doesn't respond fast enough. The screen should be 
switched off using bit 3 of the mode selection register. This prevents the 6845 
from accessing video RAM, permitting unlimited user access to video RAM. 
When data transfer ends, the screen can be switched on again. BIOS uses this 
method during scrolling, which results in the flickering "silent movie effect.” 


Color selection register 


The color selection register is located at address 3D9H. This register is write-only 
(cannot be read). 


320x200 graphic mode, 
border color in 40x25 
text mode 


color in text mode 
Number of color palette 
used in 320x200 graphic 


Color selection register 


The meanings of individual bits in this register depend on the display mode. Text 
mode uses the lowest four bits for assigning the background color from the 16 
available colors. In 320x200 graphic mode, these four bits indicate the color of all 
pixels represented by the bit combination 00(b) (background color). 
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Bit 5 selects the color palette for 320x200 mode. If this bit contains the value 1, 
the first color palette (cyan, violet, white) is selected. A value of 0 selects the 
second color palette (green, yellow, red). 


Internal registers 


The 18 internal registers of the 6845 on this card are accessed exactly like the 
monochrome card. The only difference is that the index and the data register are 
located at 3D4H and 3D5H. The following table shows the contents which the 
register must have for various display modes. 


Graphics 
56 


Text2 
113 


Textl 


Meanina 
Horiz. characters seeded 
Horiz. characters displayed 
Horiz. synchronization signal to 
... Characters 
Horiz. synchronization signal 
in characters 
ert. characters seeded 
ert. characters justified 
ert. characters displayed 
Vert. synchronization signal to 
.. Characters 
nterlace mode 
umber of scan-lines per line 
Starting line of blinking cursor 
nding line of blinking cursor 
page starting address (high b te) 
isplay page starting address (low byte) 
srsor character address (high byte) 
Cursor character address (low byte) 
Reserved 
Reserved 


=) 
pay 
© 


ui 


NO 
~ 


: 


100 
112 


te 
7) 
° 
aay 
05) 


SESE EL eer ol els 


These registers are of interest to the user since they define the position and 
appearance of the cursor on the screen. Section 10.1 described programming these 
registers. The CGA adds registers 12 and 13. They indicate the start of the video 
page which must be displayed on the screen, as offset of the beginning of the 16K 
RAM on the card (B800:0000), divided by 2. Register 12 contains the most 
significant 8 bits of this offset, while register 13 contains the least significant 8 
bits. Normally both registers contain the value 0, displaying the first screen page 
(beginning at the address B800:0000) on the screen. For display of the first screen 
page, which begins at location B800:1000 in the 80x25 text mode, the value 
1000H divided by 2 (800H) must be entered in both registers. 


The last of the three programs in this chapter accesses the color/graphics adapter. 
The only significant difference between the two preceding programs lies in the fact 
that the video controller can synchronize video RAM access and screen 
construction. This is necessary on all video cards where direct access to video 
RAM causes a flickering on the screen. The WAIT constant, defined directly after 
the program header, switches synchronization on or off. Its contents decide during 
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the assembly of the program, whether to assemble the program lines for 
synchronization listed in the source listing. These lines would slow down the 
screen considerably, and should only be included if it is absolutely necessary. 


Assembler listing: VCOL.ASM 


RRR KKE HEE EKER EERE EKER EKER EREKRKKEKHEEKEKEKERERKEKEKEK © 


tf 
st VCcOoL *; 
the ee oe en ern am ea ee ee eam one - che ce 0 ae 208 ca ce Sn SD SO eS Pn SO A A ee ED ee A ON DDD SP SD ER eH HD SN MO SE Dee ese >; 
* Task : Makes some basic functions available for *s 
7* access to the Color Graphics Adapter (CGA) *3 
3* cs em sss ems es Ss i es oS Sn os nes tm ss es em en Sets ci cued me mm cae ecm cn cli acs lind ei ist i Ss ii GS ap tu i coc an cei nes ca a = 
$* Info : All functions subdivide the screen *s 
7 into columns 0 to 79 and lines 0 to 24 x; 
:* in text mode and into columns 0 to 719 and ¥*; 
7* the lines 0 to 347 in graphic mode. *3 
es the 40 column text mode is not supported ! x; 
ied A high resolution graphic screen should appear*; 
;* first, followed by a text screen. If the high *; 
as res screen doesn't appear, try running the *s 
;* program a few times in succession. *? 
ox ssc i em si si ei hn, tensa soa ms ms tice Ss sss cu es tm cis ces: So es Gs Suu in imme tui’ Sac St Sh cs an cs econ ss i es ie ws stn a ew tna ub cms aa se ne 
rhe Author : MICHAEL TISCHER => 
ee Developed on : 8/13/87 *> 
ad Last update : 6/16/89 *s 
rig i ei cs a i sb tts ei s-seb tm lc ca eis ees ex cs sam asc Sia‘ is tw ns cases pn te’ i n'a echt sss Stn nh i baka cope ein *'s 
s* assembly : MASM VCOL (program will assemble with one “3 
tas warning - it WILL link & run) a 
ox LINK VCOL; "Ss 
* im ses in cnc es cu ts Si cin cc i emesis eo i si cs ic cs cms cae i en sn ic ca, sus ees ms is as esos sn et cis eb nis ss a's mn st Sues aren lie al = 
-* Call : VCOL = 
RAKE EKER KEKE ERE REKREKKKEKKEKKKKKKKKEKEKKK AKER KKEKAKKEKEKKEEE 9 


7== ConstantS =s==ssss=sssssssssss nase sssssSSaeSesseessssssssssssss= 
CONTROL REG = 03D8h ;Control register port address 
CCHOICE REG = 03D9h ;Color select register port address 
ADDRESS 6845 = 03D4h 76845 address register 

DATA_6845 = 03D5h 76845 data register 

VIO_SEG = OB800h 7;Video RAM segment address 

CUR_START = 10 7;Reg # for CRTC: Cursor start line 
CUR_END = 11 Reg # for CTRC: Cursor end line 
CURPG HI = 12 ;Page address (high byte) 

CURPG LO = 13 ;Page address (low byte) 

CURPOS_HI = 14 ;Reg # for CRTC: Cursor pos high byte 
CURPOS LO = 15 7Reg # for CRTC: Cursor pos low byte 
DELAY = 20000 ;Counter for delay loop 

7== Macros sss ssssscsesssssssssesssseSsssses SeSSSs SSS Ses ssSSSs esses 
7-~ SETMODE : Macro for configuring screen control register --------- 


setmode macro modus 


mov dx,CONTROL REG zAddress of the display control register 
mov al,modus ;New mode into the AL register 
out dx,al 7;Send mode to control register 
endm 
7-- WAITRET: waits until display is completed ---------~--------------- 
waitret macro 
local wrl 7Local label 
mov dx,3DAh ;Address of the display status register 
wrl: in  al,dx 7;Get content 
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local wrl ;Local label 
mov dx,3DAh sAddress of the display status register 
wrl: in al,dx »Get content 
test al,8 ;Vertical retrace? 
je wrl ;NO --> wait 
endm 
stack segment para stack ;Definition of stack segment 
dw 256 dup (?) 7256-word stack 
stack ends z;End of stack segment 
data segment para ‘DATA'‘ Definition of data segment 
initm db 13,10 
db "VCOL (c) 1988,1989 by Michael Tischer “ 
db 13,10,13,10 
db “This demo program only runs with a Color/Graphics",13,10 
db “Adapter ( CGA ). If your PC uses another type of",13,10 
db “video card press the <s> key to stop the program.",13,10 
db "Press any other key to start the program...",13,10,"$" 
strl db 1,0 
7== Table of offset addresses of line beginnings ===================== 


lines Gw 0*160, 1*160, 2*160 ;start addresses of the lines as 
dw 3%*160, 4*160, 5*160 ;offset addresses in the video RAM 
dw 6*160, 7*160, 8*160 
dw 9*160,10*160,11*160,12*160,13*160, 14*160, 15*160, 16*160 
dw 17*160,18*160,19*160, 20*160, 21*160, 22*160, 23*160, 24*160 


graphict db 38h, 28h, 2Dh, OAh, 7Fh, O6h ;register values for the 
db 64h, 70h, 02h, Olh, O6h, O7h ;graphic-modes 


textt db 71h, 50h, SAh, OAh, 1Fh, O6h ;register-values for the 
db 19h, 1Ch, 02h, O7h, O6h, O7h ;graphic-modes 


wait db 0 sTRUE (<>0) when caller uses the 
3/F switch 


data ends ;End of data segment 
code segment para 'CODE' ;Definition of the CODE segment 


assume cs:code, ds:data, es:data, ss:stack 


demo proc far 
7—-- Look for /F from DOS prompt ------------------------ 
mov cl,ds:128 7Get number of bytes from prompt 
or cl,cl 7;No parameters given? 
je switchl 7NO -~-> Ignore 
mov bx,129 7BX points to first byte in prompt 
mov. ch,bh 7Set loop high byte to 0 

switch: cmp {[bx],"F/" 7;Switch in this position? 
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switchl: 


ende: 


startdemo 


gri: 


gr2: 


gr3: 


gr4: 


grs: 


10. Accessing and Programming the Video Cards 


je switchl 
emp [bx],"f/" 
je switchl 
inc bl 

loop switch 
mov ax,data 
mov ds, ax 


mov es, ax 


mov wait,cl 


PC System Programming 


sYES --> Switch found 
;Switch in this position? 
7;YES --> Switch found 
;Set BX to next character 
7;Check next character 


7;Get segment addr. of data segment 
zand load into DS 
sand ES 


7Set WAIT flag 


7-- Display init message and wait for input ----~--------- 


mov ah,9 
mov dx,offset initm 
int 21h 
xor ah,ah 
int 16h 
cmp al,“s™ 
je ende 
cmp al, wou 
jne startdemo 
mov ax, 4C00h 
int 21h 
label near 
call grafhi 
xor al,al 
call cgr 
xor bx,bx 
xor dx,dx 
mov ax,199 
mov cx, 639 
push cx 
MOV cCxX,ax 
push ax 
mov al,l 
call pixhi 
inc dx 
loop gr2 
pop ax 
sub ax,3 
pop Cx 
push cx 
push ax 
mov al,l 
call pixhi 
inc bx 
loop gr3 
pop ax 
pop Cx 
sub cx, 6 
push cx 
mOV CX,ax 
push ax 
mov al,l 
call pixhi 
dec dx 
loop gr4 
pop ax 
sub ax,3 
pop cx 
push cx 
push ax 
mov al,l 


call pixhi 


;Function number for string display 
;Address of intial message 
;Call DOS interrupt 21H 


7Function number: get key 

7Call BIOS keyboard interrupt 

7<s> key pressed? 

7YES --> End program 

;<S> key pressed? \ 
7;NO --> Start demo 


7Function number: End program 
;Call DOS interrupt 21H 


zswitch on 320*200 pixel graphic 
;Clear graphic display 


7Column 0 

;Line 0 

;Pixels-vertical 

;Pixels-horizontal 

;Record horizontal pixels 

;Vertical pixels to counter 

7;Record vertical pixels on the stack 


7;Set pixel 

;Increment line 

7;Draw line 

7Get vertical pixels from the stack 
;Next line 3 pixels less 

7Get horizontal pixels from the stack 
7Record horizontal pixels 

7Record vertical pixels on the stack 


7Set pixel 

z;Increment column 

;Draw line 

7;Get vertical pixels from stack 

7Get horizontal pixels from stack 
7Next line 6 pixels less 

;Record horizontal pixels 

;Vertical pixels to counter 

;Record vertical pixels on the stack 


7Set pixel 

;Decrement line 

7;Draw line 

7;Get vertical pixels from stack 
;Next line 3 pixels less 

7Get horizontal pixels from stack 
;Record horizontal pixels 

;Record vertical pixels on the stack 


7Set pixel 
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demoi : mov 


mov 


demo2: inc 


call 
loop 


xor 
int 
inc 


cmp 
jne 


xor 
call 


jmp 


demo endp 


7== The actual functions follow 


=e Sa Ve Re 
I 
§ 


text 


text 


Se "2 SNe Re 


TEXT: switches the text display on 


Input : 
Output : 
Register : 


proc 
Mov 
Mov 


jmp 


endp 


GRAFHI: switches the 640*200 pixel graphic mode on 


bx 
gr5 
ax 
cx 
cx, 6 
ax, 5 
gril 


ah, ah 
16h 


text 
bp, bp 
ai, 30h 
ax, bp 
strl,al 
setcol 
setpage 
cls 

bx, bx 
calo 
cx, 2000 
ah,ah 
si,offset ‘strl 
ah 
print 
demo2 


ah, ah 
16h 
bp 
bp, 4 
demol 


bp, bp 
setpage 
ende 


none 
none 


sIncrement column 
;Draw line 


7Get vertical pixels from the stack 
7;Get horizontal pixels from the stack 


7Next line 6 pixels less 


yIs the vertical line longer than 5 


sYES~--> continue 


:Wait for function number of key wait 


7;Call BIOS keyboard interrupt 


sSwitch on 80x25 character text mode 


;Process screen page 0 first 
7;ASCII code "0" 

7Convert page number to ASCII 
7Store in string 

7Set color 

;Activate screen page in BP 
7;Clear screen page 

7;Begin in the upper left 
;Screen corner with output 
7A page contains 2,000 characters 
;Start with color code 0 
7Offset address of string 1 
;iIncrement color value 
7Output string 1 

;Repeat until screen is full 


;Wait for key 

7Call BIOS-Keyboard-Interrupt 
;increment page number 

7All 4 pages processed ? 

7NO --> then next page 


;Activate page O again 


;Goto program end 


I 


AX, SI, BH, DX and FLAGS are changed 


near 


si,offset textt 


b1,00100001b 
short vcprog 


Input : none 


Output 


= none 


;Offset address of the register-table 


780x25 text mode, blinking 
;Program video controller again 


Register : AX, SI, BH, DX and FLAGS are changed 


grafhi proc 


mov 
jmp 


grafhi endp 


™e ™e Re Ve 
in| 
an | 


GRAFLO: switches the 320*200 pixel graphic mode on 


near 


b1,00010010b 
short graphic 


Input : none 
Output =: none 
Register : AX, SI, BH, DX and FLAGS are changed 


;Graphic mode with 640*200 pixels 


;Program video controller again 
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graflo proc near 


mov bl,00100010b 7Graphic mode with 320*200 pixels 
graphic: mov si,offset graphict ;Offset address of the register table 


graflo endp 


-- VCPROG: programs the video controller -------------- nnn en 
-- Input : SI = Address of a register table 

~-— BL = Value for display control register 

-- Output none 

Register : AX, SI, BH, DX and FLAGS are changed 


“Ne Re Me Ve Ws 


veprog proc near 


setmode bl ;Bit 3 = O: screen off 
mov cx,12 712 registers are set 
xor bh,bh 7Start with register 0 
vepl: lodsb 7Get register value from table 
mov ah,al 7Register value to AH 
mov al,bh ;Number of the register to AL 
call setvk ;Transmit value to controller 
inc bh ;Address next register 
loop vcpl 7Set additional registers 
or bl1,8 7Bit 3 = 1: screen on 
setmode bl ;set new mode 
ret ;Back to caller 


veprog endp 


77~ SETCOL : Sets the color of the display frame and Background -~---- 
77— Input : AL = color value 
77~ Output : none 
7-~ register : AX and DX are changed 
j~-- Info : in text mode the lowest 4 bits indicate the frame color 
i-~ in graphic mode the lowest 4 bits indicate the frame 
;-~ and background color, bit 5 selects the color palette 
setcol proc near 
mov dx,CCHOICE REG Address of the color selection register 
out dx,al ;Output color value 
ret 7;Back to caller 
setcol endp 
~~ CDEF sets the start and end line of the cursor -------------- 


-- Input : CL = start line 
-— CH = end line 


me oe Ve Re We 


-~ Output : none 
-- register : AX and DX are changed 
cdef proc near 
mov al,CUR_START 7Register 10: start line 
mov ah,cl 7;Start line to AH 
call setvk :Transmit to video controller 
mov al,CUR_END Register 11: end line 
mov ah,ch ;End line to AH 
jmp short setvk ;Transmit to video controller 
cdef endp 
7-~ SETPAGE : sets the screen page ------------ 9 nnn rn 
7-- Input : BP = Number of the screen page (0 to 3) 
77~ Output : none 
7-- register : BX, AX, CX and DX are changed 
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z-- Info : in the Graphic modes the first screen page has the 
;-- number 0, the second the number 2 
set page proc near 
mov bx,bp 7Screen page to BX 
mov cl,5 7Multiply by 2,048 
ror bx,cl 
mov al,CURPG HI 7Register 12: Hi byte page address 
mov ah,bh ;Hi byte of the screen page to AH 
call setvk ;Transmit to video controller 
mov al,CURPG LO 7;Register 13: Lo byte page address 
mov ah,bl 7Lo byte of the screen page to AH 
jmp short setvk 7;Transmit to video controller 
setpage endp 
7-~ SETBLINK : sets the blinking cursor ~---------------<----<---------- 
g7- Input : DI = Offset address of the cursor 
77~- Output : none 
;7-~ register : BX, AX and DX are changed 


setblink proc near 


mov bx,di 7Move offset to BX 

mov al,CURPOS HI 7Hi byte of the cursor offset 
mov ah,bh 7HI byte of the offset 

call setvk ;Transmit to video controller 
mov al,CURPOS LO ;Lo byte of the cursor offset 
mov ah,bl 7Lo byte of the offset 


;-~ SETVK is called automatically --------------~------------- 


setblink endp 


7-~- SETVK : sets a byte in one register of the video controller ~--- 
f-- Input : AL = Number of the register 

3-- AH = new content of the register 

77— Output : none 

;-- register : DX and AL are changed 

setvk proc near 


mov dx,ADDRESS 6845 ;Address of the index register 


out dx,al 7;Send number of the register 

jmp short $+2 7Short I/O pause 

inc dx 7Address of the index register 

mov al,ah 7;Content to AL 

out dx,al 7Set new content 

ret. ;Back to caller 
setvk endp 
7—~- GETVK gets a byte from one register of the video controller - 
;-- Input AL = Number of the register 


AL = Contents of register 


a 
¢7~ Output 
: DX and AL are changed 


~- register 
getvk proc near 


mov dx,ADDRESS 6845 ;Address of the index register 


out dx,al ;Send number of the register 
inc dx ;Index register address 
jmp short $+2 7Short io pause 
in al,dx 7;Set new contents 
ret 7;Back to caller 
getvk endp 
77~ SCROLLUP: scrolls a window N lines upward --~----------------------- 
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j-- Input : BL = line upper left 

-— BH = column upper left 

-— DL = line below right 

— DH = column below right 

- CL = Number of lines, to be scrolled 
BP = Number of the screen page (0 to 3) 


™e “Se “ses Se “Se “oe Se Me 
1 


-- Output : none 
~~ register : only FLAGS are changed 
-- Info : the display lines liberated are cleared 


scrollup proc near 


cld 7On string commands count up 
push ax ;All changed registers to the 
push bx 7;Secure stack 
push di ;In this case the sequence 
push si 7must be observed ! 
push bx ;These three registers are returned 
push cx sbefore the end of the routine 
push dx ;From the stack 
sub dl,bl ;Calculate the number of lines 
inc dl 
sub dl,cl ;Subtract number of lines to be scrolled 
sub bh,dh ;Calculate number of columns 
inc dh 
call calo ;Convert upper left in offset 
mov si,di ;Record address in SI 
add bl,cl 7First line in scrolled window 
call calo ;Convert first line in offset 
xchg si,di ;Exchange SI and DI 
cmp wait,0 ;Flicker suppressed? 
je sup0 7;NO --> SUPO 
waitret sYES -->Wait for retrace 
setmode 00100101b ;Disable screen 

sup0: push ds ;Store segment register 
push es 7On the stack 
mov ax,VIO_ SEG ;Segment address of the video RAM 
mov ds,ax 7To DS 
Mov eS,ax ;And ES 

supl: mov ax,di 7Record DI in AX 
mov bx,si sRecord SI in BX 
mov cl,dh sNumber of columns in counter 
rep movsw ;Move a line 
mov di,ax 7Restore DI from AX 
mov si,bx ;Restore SI from BX 
add di,160 7;Set next line 
add si,160 
dec dl 7processed all lines ? 
jne supl 7;NO --> move another line 
pop es ;Get segment register from 
pop ds 7; Stack 
cmp wait,0 Flickering suppressed? 
je sup2 7NO --> SUP2 
setmode 00101101b 7YES --> Enable screen 

sup2: pop dx 7Get lower right corner back 
pop cx ;Return number of lines 
pop bx ;Return upper left corner 
mov bi,dl ;Lower line to BL 
sub bl,cl ;Subtract number of lines 
inc bl 
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ret 
scrollup endp 


-- SCROLLDN: 
-- Input : 


register 
-- Info 


=e Se Ws Be Re We Ve Be Be NO 


-- Output : 


scrolldn proc 
cld 


push 
push 
push 
push 


push 
push 
push 


sub 
inc 
Mov 
mov 
call 
mov 
sub 
call 
xchg 
sub 
inc 
sub 


cmp 


je 


wait 


setmode 00100101b 


ah, 07h 
clear 


si 
di 
bx 
ax 


7Color : black on white 
;Clear lines 


7CX and DX have already been 
7 Restored 


;Back to caller 


scrolls a window N lines down ----------<<----<----------- 
BL = line upper left 

BH = column upper left 

DL = line below right 

DH = column below right 

CL = number of lines to be scrolled 

BP = number of the screen page (0 to 3) 


none 


only FLAGS are changed 
the display lines liberated are cleared 


near 


ret 


sdn0: push ds 
push es 
mov ax,VIO_SEG 
mov ds,ax 
MOV eS,ax 

sdni: mov ax,di 
mov bx,si 
mov cl,dh 
rep movsw 
mov di,ax 
mov si,bx 
sub di,160 
sub si,160 
dec dl 


7On string commands count up 


;Record all changed registers 
7On the stack 

7in this case the sequence 
;Must be observed ! 


7These three registers are returned 
7From the stack before the end 
;Of the routine 


;Calculate the number of columns 


7Record line upper left in AL 

;Line below right to line below left 
;Convert upper left in offset 

;Record address in SI 

;Subtract number of characters to scroll 
;Convert upper left in offset 

;Exchange SI and DI 

;Calculate number of lines 


;Subtract number of lines to be scrolled 


;Flicker suppressed? 
7NO --—> SDNO 


7;YES --> Wait for retrace 
;Disable screen 


;Store segment register on the 

7 Stack 

7;Segment address of the video RAM 
7TO DS 

zand ES 


;Record DI in AX 

7Record SI in BX 

sNumber of columns in counter 
7;Move a line 

7;Restore DI from AX 

7Restore SI from BX 

7;Set into next line 


7processed all lines ? 
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sdn2: 


scrolldn 


Input. 
Out put 
regist 


me Ve Ve Ve 
t 
{ 


Q 
| ee 
a 


Q 
w~ 
07) 


Input 


Output 


“™e Ms Se Bs Me Me Ne Ns Ne 


clear 


jne sdnl 
pop es 
pop ds 
cmp wait,0 
je  sdn2 


setmode 00101101b 


pop dx 
pop cx 
pop bx 
mov dl,bl 
add dl,cl 
dec dl 
mov ah,0O7h 
call clear 
pop si 
pop di 
pop bx 
pop ax 
ret 

endp 


;NO --> move another line 


;Return segment register from 
7 Stack 


7Flicker suppressed? 
7NO --> SDN2 


7;YES --> Enable screen 


7;Get lower right corner 
;Return number of lines 
;Return upper left corner 
;upper line to DL 

;Add number of lines 


7;Color : black on white 
;Erase liberated lines 


7CX and DX have already been 
7; Returned 


;Back to caller 


CLS: Clear the screen completely ------------------ 99-3 


: BP = number of the screen page (0 or 1) 


« none 


er : only FLAGS are changed 


proc near 


mov ah,O7h 
xor bx,bx 


mov dx, 4F18h 


;-- Execute Clear 


endp 


7;Color is white on black 
yupper left is (0/0) 
;Lower right is (79/24) 


CLEAR: fills a designated display area with space characters ------ 


: AH = attribute/color 
BL = line upper left 
BH = column upper left 
DL = line below right 
DH = column below right 
BP = number of the screen page (0 to 3) 


proc near 


cld 

push cx 
push dx 
push si 
push di 
push es 
sub dl,bl 
inc dl 
sub dh,bh 
inc dh 
call calo 


mov cx,VIO SEG 


mov es, Cx 
xor ch,ch 


register : only FLAGS are changed 


7;On string commands count up 
;Store all register which are 
;Changed on the stack 


;Calculate number of lines 
7;Calculate number of columns 


;Offset address of the upper left corner 
7;Segment address of the video RAM 

7To ES 

7Hi bytes of the counter to 0 
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mov al," ™ 
cmp wait,0 
je  clearl 
push dx 
waitret 
setmode 00100101b 
pop dx 
clearl: mov si,di 
mov cl,dh 
rep stosw 
mov di,si 
add di,160 
dec dl 
jne clearl 
cmp wait,0 
je clear2 


setmode 00101101b 


clear2: pop 


clear endp 


7-~ PRINT: outputs a string on the screen 


77~~- Input : 


-- Output 
-- register 
-- Info 


"Se “Ss Ss Se Se Ve 2 


print proc 


cld 
push 
push 
push 
push 
mov 
mov 
mov 


jmp 
printl 


or 


je 


push 
mov 
hrl: in 
test 
jne 
cli 
hr2: in 
test 
je 
pop 


es 
di 
si 
dx 
cx 
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7;Space character 


7;Flickering suppressed? 
7;NO --> CLEAR] 


7; Store DX on the stack 
;Retrace wait 

7Switch screen off 
;Return DX from the stack 


sRecord DI in SI 

;Number columns in counter 
7;Store space character 
7;Return DI from SI 

7Set in next line 

;All lines processed ? 

7;NO --> erase another line 


7;Flicker suppressed? 
;NO --> CLEAR2 


;Enable screen 


7Get registers from 
7Stack again 


;Back to caller 


AH = attribute/color 

DI = offset address of the first character 
SI = offset address of the strings to DS 
BP = number of the screen page (0 to 3) 

DI points behind the last character output 
AL, DI and FLAGS are changed 

the string must be terminated by a NUL-character. 
other control characters are not recognized 


near 


dx, VIO_SEG 
cl,wait 
es, ax 


short print3 


label near 


cl,cl 
print2 


ax 
dx, 3DAh 
al, dx 
al,l 
hrl 


al, ax 
al,l 
hr2 
ax 


7On string commands count up 


;Store SI, DX and ES on the stack 


7;Segment address of the video RAM 


7Get WAIT flag 


7First to DX and then to ES 


7;Get character and display 


7Flicker suppressed? 
7NO ~-> PRINT2 


it 


;Record characters and color 


;Address of the display-status-register 


7;Get content 
;Horizontal retrace? 
7;NO --> wait 


7permit no further interrupts 


7Get content 
;Horizontal retrace? 
7YES --> wait 


;Restore characters and color 
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sti 7;Do not suppress Interrupts any more 
print2: stosw ;Store attribute and: color in V-RAM 
print3: lodsb 7Get next character from the string 
or al,al zIs it NUL 
jne printi 7;NO --> output 
printe: pop dx 7;Get SI, DX, CX and ES from stack 
pop cx 
pop es 
pop si 
ret ;Back to caller 
print endp 
s-- CALO: Converts line and column into offset address ---------------- 
z-~- Input : BL = line 
i-- BH = column 
+ Hoaaia BP = number of the screen page (0 to 3) 
z-- Output : DI = the offset address 
z-- register : DI and FLAGS are changed 
calo proc near 
push ax 7;Secure AX on the stack 
push bx 7;Secure BX on the stack 
shl bx,1 7Column and line times 2 
mov al,bh 7;Column to AL 
xor bh,bh 7Hi byte 
mov di, [linestbx] sGet offset address of the line 
xor ah,ah 7HI byte for column offset 
add di,ax ;Add line and column offset 
mov bx,bp 7Screen page to BX 
mov cl,4 7Multiply by 4,096 
ror bx,cl 
add di,bx ;Add beginning of screen page to offset 
pop bx ;Restore BX from stack 
pop ax ;Restore AX from stack 
ret 7;Back to caller 
calo endp 


CGR: Erase the complete Graphic display 


7-- Input : AL = OOH : erase all pixels 
;-= FFH : set all pixels 
7—7~ Output : none 
;-~ register : AH, BX, CX, DI and FLAGS are changed 
7-- Info : this Function erases the Graphic display in both 
;-- Graphic modes 
cgr proc near 
push es 7Store ES on the stack 
chow 7Expand AL to AH 
xor di,di ;Offset address in video RAM 
mov bx, VIO_SEG 7Segment address screen page 
mov es, bx ;Segment address into segment register 
mov cx, 2000h 7;One page is 8KB words 
rep stosw 7;Fill page 
pop es 7;Return ES from stack 
ret ;Back to caller 
cor endp 


PIXLO: sets a pixel in the 320*200 pixel graphic mode 
Input : BP = number of the screen page (0 or 1) 

BX = column (0 to 319) 

DX = line (0 to 199) 

AL = color of the pixels (0 to 3) 


me Se Bo Be Re 
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LA 


e 


pixlo 


pixlo 


2 aa 
e 
9 ae 
v 


=e “es “Ne We Re 


pixhi 


Output : 
register : 


proc 


push 
push 
push 
mov 
mov 
and 
shl 
sub 
mov 
shl 
not 
shr 
shr 
jmp 


endp 


PIXHI: sets a 


Input : 


Output : 
register : 


proc 


push 
push 
push 
mov 
mov 
and 
sub 
mov 
shl 
not 
mov 
shr 


pixhi 


2 am 
e 
oo 
f 

© am 
’ 

© aw 
’ 

° m= 
LA 

© cam 
s 
° 
’ 


spix 


SPIX: sets 
Input : 


Output 
register 


proc 


push 
push 
push 


xor 
mov 
mov 
mov 
shr 
mov 
mul 


none 


AX, DI and FLAGS are changed 


near 


ax 
bx 

cx 

cl,7 

ah,bl 
ah,11b 
ah,l 

cl.ah 
ah,11 

ax, cl 

ah 

bx, 1 

bx, 1 

short spix 


;Secure AX on the stack 
;Note BX on the stack 
;Store CX on the stack 


;Transmit column to AH 
7;Column mod 4 

7;Column * 2 

2:7 - 2 * {column mod 4) 
;Bit value 

7Move to pixel position 

7; Reverse AH 

;Divide BX by 4 by shifting 
7Right twice 

7Set pixel 


pixel in the 640*200 pixel graphic mode ----------------- 


BP = number of the screen page (0 or 1) 


BX 
DX = line 


column (0 to 639) 
(O to 199) 


AL = color of the pixels (0 or 1) 


none 


AX, DI and FLAGS are changed 


near 


ax 

bx 

cx 

cl? 
ah,bl 
ah,111b 
cl,ah 


endp 


7; Store AX on the stack 
;Note BX on the stack 
7;Note CX on the stack 


;Transmit column to AH 
7Column mod 8 

77 - column mod 8 

7;Bit value 

7Move pixel position 
,Reverse AH 

33 shifts 

;Divide BX by 8 


a pixel in the graphic display --------------------------- 


BX = column offset 

(0 to 199) 

Value to cancel old Bits 
AL = new Bit value 


DX = line 
AH 


none 


AX, DI and FLAGS are changed 


near 


es 
ax 
ax 


di,di 
cx, VIO_SEG 


;Secure ES on the stack 
;Secure DX on the stack 
7;Secure AX on the stack 


7Offset address in video RAM 

7segment address screen page 

;Segment address into segment register 
7Move line to AX 

;Divide line by 2 

7The factor is 90 

7Multiply line by 80 
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spix 


ret 


endp 


dx, 1 

cl,3 

dx, cl 
di,ax 

di, dx 

di, bx 

ax 

bl,es: [di] 
bl,ah 
bl,al 

es: (di],bl 


ax 
es 
cx 
bx 
ax 


;Line mod 2 

73 shifts 

;Rotate right (* 2000H) 
780 * int (line/2) 

3+ 2000H * (line mod 4) 
;Add column offset 
;Return AX from stack 
7;Get pixel 

;Erase Bits 

;Add pixel 

gwrite pixel back 


7;Return DX from stack 
;Return ES from stack 
7;Return CX from stack 
;Return BX from stack 
;Return AX from stack 


;Back to caller 


PC System Programming 


code 


ends 
end 


demo 


7End of the code segment 
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10.5 EGA and VGA Cards 


The EGA and VGA cards far exceed their predecessors in both graphics and in text 
display capabilities. Other computers have had EGA and VGA capabilities for 
some time (e.g., work stations, CAD/CAM applications), but these video cards are 
now at prices where many home systems will soon have them. 


The range of power of this new generation of video cards can be seen in their very 
sharp resolutions and their ability to display almost any number of lines on the 
screen. The EGA and VGA cards' greatest feature lies in their ability to emulate 
other video cards. 


These capabilities come with a price—more complicated hardware and 
programming are required. One result of this is that the features of an EGA card or 
a VGA card can no longer be realized with the traditional PC video controller (the 
Motorola 6845). Instead, most EGA and VGA cards contain a VLSI chip developed 
especially for use on an EGA card. At the heart of this component is a video 
controller that controls the video signal generation. Its basic task is similar to that 
of the 6845, but its registers differ from those of the 6845, both in number and 
interaction between registers. Comparing the 6845 and VSLI is like comparing 
BASIC and assembly language, where the increase of power is in proportion to the 
degree of language complexity. 


We recommend that you avoid programming the hardware registers directly unless 
you absolutely must do so. Many tasks can be delegated to the BIOS without 
wasting much time. Not only will this keep your program code more compact and 
easier to read, it will greatly improve the compatibility of your code with other 
video cards. Among the tasks which the various functions of the BIOS video 
interrupt can perform are: 


. Initialization of the video mode 

° Selection of the display page 

° Cursor positioning 

° Defining the starting and ending line of the cursor 

° Palette and border color selection 

° Setting the size of the character matrix, and thereby the number of text 


lines which can be displayed on the screen 
° Loading user-defined character sets 
° Reading configuration data 


Detailed information about traditional BIOS video functions and the new functions 
of the EGA/VGA BIOS can be found in Sections 7.4. 
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If you need speed and maximum control over the screen, you should still perform 
time-critical actions (e.g., manipulating video RAM) "by hand.” 


EGA/VGA and text mode 


There is no difference between the EGA and MDA or CGA card in text mode. The 
video RAM and attribute byte are organized the same way for the EGA card as for 
the other two cards—even the location of the video RAM is the same. But since an 
EGA card can emulate either a CGA card or an MDA card, depending on the 
monitor to which it is connected, you should first determine what kind monitor is 
in use. From this the EGA can determine which of the two systems to emulate 
(routines presented in Section 10.7 show how this is done). The type of card being 
emulated determines where the video RAM can be found in memory, how the bits 
of the character attribute byte are interpreted, and how many screen pages are 
available. 


Remember that the EGA or VGA card does not contain a 6845 CRTC, despite the 
fact that it can perfectly emulate its video predecessors. This means that the status 
and control registers of the MDA and CGA cards are unavailable. However, since 
the settings that are normally made with these registers can also be performed with 
the BIOS, we don't really need these registers. You should also remember that 
there are no restrictions to accessing the video RAM of an EGA card or a VGA 
card when it is in CGA emulation. It is unnecessary to synchronize screen access 
with the activity of the CRTC by reading the status register. 


The parallels between the organization of the video RAM in the CGA and MDA 
cards also apply when the text mode is switched to 43 lines (which is impossible 
in CGA emulation). As with any other number of displayed lines, this does not 
change the basic structure of the video RAM at all. It is larger, but the formulas 
for calculating the offset position of a character and its attribute byte within the 
video RAM are still valid. 


The VGA card is capable of 25, 43 and even SO lines in text mode, depending on 
the monitor in use. 


These parallels also apply to the graphics modes already available to the CGA card. 
The position of the video RAM and its structure are identical to the those of the 
CGA card. 


EGA/VGA and graphic modes 
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The EGA card offers the following new graphics modes: 


° 320x200 pixels, 16 colors (BIOS code: ODH) 
° 640x200 pixels, 16 colors (BIOS code: 0OEH) 
° 640x350 pixels, 2 colors (BIOS code: OFH) 
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° 640x350 pixels, 16 colors (BIOS code: 10H) 
The VGA card offers the following graphic modes: 


° 640x480 pixels, 2 colors (BIOS code: 11H) 
° 640x480 pixels, 16 colors (BIOS code: 12H) 
° 320x200 pixels, 256 colors (BIOS code: 13H) 


Some EGA cards have even more modes with higher resolution or more colors, 
but these modes are not part of the EGA standard and are supported by only a few 
programs. 


It is somewhat difficult to talk about a "standard", because almost every 
manufacturer has their own modes. Let's look at the lowest common 
denominator—the modes which practically all EGA/VGA cards support. These are 
the modes supported by the original EGA card, the IBM EGA. 


These video modes, in which the video RAM can occupy more than 100K, show a 
structure quite different from those used by the MDA, CGA and Hercules cards. 
The maximum of 256K of RAM is divided into four bitplanes which are arranged 
in a kind of a three-dimensional organization. From the processor's point of view 
these bitplanes reside between segment addresses AOOOH and BOOOH. 


Each bitplane contains one bit for each individual pixel. If you place the bitplanes 
on top of each other, each pixel is represented by a total of four bits, which 
together make up the color value of the pixel. Bitplane zero contains bit zero of 
the color value of each pixel, bitplane one contains bit one, and so on. This limits 
the number of displayable colors to 16, since four bits (or bitplanes) can represent 
24 or 16 different numbers. 


The color value obtained from combining individual bitplanes does not correspond 
directly to a color. It is actually used as an index into one of the 16 palette 
registers of the EGA card, each of which designates a particular color. Since the 
EGA card can display a total of 64 different colors, the palette registers allow you 
to select 16 of these colors to be displayed on the screen simultaneously. The 
individual palette registers can be loaded with the help of the extended EGA BIOS 
functions, as described in Section 7.4. 


The structure of each bitplane corresponds to the organization of the pixels on the 
screen, and parallels that of video RAM in text mode. Since each pixel occupies 
one bit in the bitplane, eight consecutive pixels are combined into a byte. The 
pixels on each line are placed left to right in successive memory locations. The 
length of each line can be determined using the formula: 


horizontal _ resolution / 8 
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Since the individual screen lines follow each other in sequence starting from the 
top of the screen, the starting address of each line is obtained by multiplying the 
line number by this value. The byte within this line which contains the desired 
pixel is calculated by dividing the column number by eight (bits per byte). Adding 
this to the starting address of the line gives us the following formula, which 
calculates the offset address of the byte containing the coordinates (X, Y): 


Y * (horizontal resolution / 8) + X / 8 


X columns 


A000:0000 [G111._ Ww 
cat at” a - 
A000:0000 [001: mG 
a el H- 
A000:0000 1: 0/1; _ wy] ot 2 
a a" ate - 
A000:0000 [a0:1:. wht | p4° 
mals 3 Oo Y lines 
wy 
22 fe 
ppd. p . 
I Ray Soa @o N 
ot oo Ww 


ood deodeccsee 


oe Peper 


: °. 
ie oP eewevecvcce 


Video Display Monitor 


Bitplane arrangement on EGA card 


The bit number at which the pixel is located in this byte results from the 
remainder of the division of the column number by eight: 


7 - (column_number MOD 8) 


These two formulas can be used to localize a pixel within a bitplane and 
implement graphics primitives. 


However, the bitplanes cannot be accessed individually because they all lie at the 
identical segment address. The EGA card has four latch registers, each of which 
contains a complete byte from one of the four bitplanes. When the CPU performs 
a read access from the EGA video RAM at segment address AQOOH, one byte is 
first read from each of the four bitplanes at the specified offset address and loaded 
into the four latch registers. This applies to instructions which access memory 
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directly, such as MOV or LODS, as well as all instructions in which a byte from 
the video RAM appears as an operand. This can be the case with arithmetic 
instructions (ADD, SUB, OR, AND, etc.) and comparison instructions (CMP, 
CMPS). 


The process is similar for writing bytes to the video RAM. In this situation the 
contents of the four latch registers are written back to the four bitplanes. 


bits 01234567 


access LATCHES 


Video RAM access—loading the four latch registers 


= 


BITPLANES 


bits 01234567 


CPU 
write 


access LATCHES 


Video RAM access—writing the four latch registers 


Since the latch registers are not directly accessible to the processor, we must 
alternate conversion between eight and 32 bits when reading and writing the video 
RAM. When reading, 32 bits from the latch registers must be compressed into one 
byte, while the eight bits from the CPU when writing must be divided among the 
32 bits of the latch registers. The nine graphic controller registers in the EGA card 
perform this conversion. 
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[Eca graphic controller registers and their default values | 
Ce Coe TTT 


Miscellaneous varies 


1o7H ~——~«| color Don't Care 
[08H | Bit Mask_ | 


Access to these registers is similar to CRTC register access on the Hercules 
graphics card. Here too there is an address register at port address 3DEH, into 
which we must first load the number of the register in the graphics controller that 
we want to access. The value for this register can then be written to the data 
register located at address 3CFH, immediately after the address register. These ports 
do not have to be accessed separately: A 16-bit OUT instruction to the address 
register performs the access in one move. The AX register, which will be sent to 
this port, must contain the register number in the low-order byte (AL), and the 
value for this register in the high-order byte (AH). Although values can be loaded 
into the graphics controller registers in this manner, it is not possible to read data 
from the EGA card. 


The contents of register number five, the mode register, are responsible for the 
behavior of the video RAM. This register controls the current read and write 
modes and thereby the manner in which the data from the latch registers is 
combined with the other registers in the graphics controller and the CPU data. 


Write mode | 
Possible modes: 
0, 1 and 2 


Read mode 
Possible modes: 
0 and 1 


Mode register structure in EGA card graphics controller 


There are a total of two different read modes and three write modes. 
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Read mode 0 


Read mode 0 is the simpler of the two read modes. As usual, a read access in this 
mode first loads the specified byte from the four bitplanes into the four latch 
registers. Then the contents of the latch register specified by the lower two bits of 
the read map select register (register four) are transferred to the CPU. 


IXXXXXX|} OO} 
Read Map 
Select Register 


Video RAM read access in read mode 0 


The following sequence of assembly language instructions first sets read mode 0, 
then writes the value 2 into the Read Map Select register, and finally reads a byte 
from offset address 0003H in the video RAM. As a result, the AL register contains 
the bit values for the pixels with coordinates (24, 0) to (31, 0) from bitplane 2. 


mov dx, 3CEh 7port address of the graphics cont. addr. reg. 
mov ax,0005h swrite read mode 0 in the mode register 

out dx,ax 

mov ax,0204h ;write the value 2 (plane number) in the 

out dx,ax ;read map select register 

mov ax, OA000h ;segment address of the video RAM 

mov ds, ax sto DS 

mov si,0003h ;offset address into the video RAM 

lodsb ;read byte from plane 2 


Read mode 1 


Read mode 1 specifies which of the eight pixels in the specified byte of video 
RAM is set to a certain color. This is determined by the individual bits in the read 
byte which correspond to the one of the eight pixels from the specified byte in the 
video RAM. If a pixel has the specified color (appropriate bit map), then the 
corresponding bit will be 1, else 0. The bit pattern of the color to be compared 
must be loaded into the lower four bits of the Color Compare register. The lower 
four bits of the Color Don't Care register show which bitplanes will be taken into 
consideration in the comparison. The value 1 includes the given plane in the 
comparison, while the value 0 excludes it. 
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BITPLANES 


Vy) Color don't care 
AND | = register 


Color Compare 
Register 


Video RAM read access in read mode 1 


The following program sequence determines which of the pixels between 
coordinates (0, 0) and (7, 0) have color value five. First, read mode 1 is set by the 
Mode register. Then the color value to be tested (five) is loaded into the Color 
Compare register. We must also load the Color Don't Care register with the value 
1111b so that all four bitplanes will be included in the comparison. However, this 
is the default value and we have not loaded any other value into this register, so we 
can skip this step. After programming the registers of the graphics controller, we 
load the segment and offset addresses of the pixels to be compared into the DS and 
SI registers. Then the read is executed from the video RAM. 
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mov dx, 3CEh sport address of the graphics cont. addr. reg. 
mov ax, 0805h ;write read mode 1 into the mode register 

out dx,ax 

mov ax,0502h gwrite color value 15 into the 

out dx, ax ;Color Compare register 

mov ax, OAO000Oh 7;segment address of the video RAM 

mov ds,ax zto DS 

xor si,si yload offset address 0 

lodsb ;read and compare pixels, 


sreturn result in AL 


Write mode 0 


Writing to the video RAM in write mode 0 results in a number of operations, all 
of which depend on the contents of several registers. The contents of the Bit Mask 
register determine whether the value of a bit in the four latch registers will be 
written unchanged to the found bitplanes or whether it will first be modified. The 
individual bits in the Bit Mask register correspond to the individual bits in the four 
latch registers. If a bit in the Bit Mask register is 0, the corresponding bits in the 
latch registers will be written to the bitplanes unchanged. If this bit is 1, a 
modification will take place, dependent on the contents of the Function Select 
register. As the following figure shows, the bits can be replaced or modified with 
the logical operations AND, OR, and XOR. 


Comparison modes 
OOb = Replace 
01b = AND comparison 
10b = OR comparison 
11b = XOR comparison 


Function Select Register structure in EGA card graphics controller 


The contents of the Enable Set/Reset register determines from where the other 
operand in these operations will come. If the lower four bits contain the value 1, 
the other operand will come from the lower four bits of the Set/Reset register. 
Each of these bits is then combined with the bits from the latch registers as 
described by the contents of the Function Select register. All of the bits to be 
modified from latch register 0 will then be operated on with bit 0 of the Set/Reset 
register. In the same manner, all of the bits to be modified from latch registers 1, 
2, and 3 are combined with bits 1, 2, and 3 of the Set/Reset register, respectively. 
The byte which is actually written to the graphics controller becomes irrelevant at 
this point—the write access is reduced to a trigger, which cannot have any direct 
influence on the contents of the latch register (and therefore the bitplanes). 
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Latch #0 Latch #1 Latch #2 Latch #3 


ete 0 .e Hi 
OH0:0: 


ae TUTE 


a 
Farction 
aes 


CLOLDDEE 
Byte in: a #0 Bitplane #1 ae #2 Sey #3 
Write access to video RAM (write mode 0) when Enable Set/Reset register 
contains a value of 00001111(b) 


The following assembly language fragment assigns the pixels at coordinates (5, 0) 
and (7, 0), found at offset address OOOOH in the video RAM, the color 1011(b). 


Since we don't want to change the color of the other pixels, the contents of the 
byte are first read into the latch register with a read access to the video RAM. It is 
not important which read mode is active because the byte transmitted to the CPU 
is irrelevant; all we are interested in is loading the latch register. Since only bits 0 
(coordinates (7, 0)) and 2 (coordinates (5, 0)) will be changed, we load the value 
00000101b (05h) into the bitmask register. In the Function Select register we 
write the value 0 because we want to replace bits 0 and 2 with a new bit 
combination. We write the color we want to give to the two bits (1011b = OBh) in 
the Set/Reset register. We must also write the value 1111(b) (OFH) to the Enable 
Set/Reset register of the graphics controller so that the color value will be taken 
from the Set/Reset register. We can then execute the write access to video RAM. 


mov ax, OAQ0Oh ;segment address of the video RAM 

mov ds, ax 7;to DS 

xor bx, bx zload offset address 0 

mov al, [bx] ;load byte 0 in the latch register 

mov dx, 3CEh ;port address of the graphic cont. addr. reg. 
mov ax, 0005h ;read mode 0, write more 0 

out dx, ax ywrite in the mode register 

mov al,03h swrite 0 in the Function Select register 

out dx,ax 

mov ax,0508h gwrite bit mask in the bitmask register 

out dx,ax 

mov ax, OBOOh ;write new color value in the Set/Reset register 
out dx,ax 

mov ax, OFO1h zwrite 1111b in the Enable Set/Reset register 
out dx,ax 

mov [(bx],al ;trigger latch regiscer 


Things are different when the Enable Set/Reset register contains the value zero. In 
this case all of the bits to be modified from the four latch registers are combined 
with the CPU byte latch by latch. Here again the type of operation performed 
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depends on the contents of the Function Select register. For example, if the OR 
operation is selected and bits 1, 2, 4, and 6 are to be modified, than these bits of 
all four latch registers will be individually ORed with bits 1, 2, 4, and 6 in the 
CPU byte. 


Latch #0 Latch #1 Latch #2 Latch #3 


Wet eT 


TOO OCS 

CPU data byte 
ee Ca 

— 

Furctiicon 

select 

register 


OO OFT EEO B] OL LIOLOL 10} ANN 
Byte in: aa #0 Bitplane #1 Bitplane #2 ae #3 


Write mode 1 


Write mode 1 is quite simple compared to the complex operations of write mode 0. 
The contents of the registers and the CPU byte are irrelevant because the contents 
of the four latch registers are loaded unchanged into the specified offset address 
within the four bitplanes. This is useful for copying the color values of eight 
successive pixels to eight other pixels, for instance. The byte containing the eight 
pixels can be read under one of the read modes, placing it in the latch registers. 
Then a write access can be made to the byte in video RAM to which you want to 
copy the color values. The graphics controller will automatically copy the contents 
of the latch registers to the specified position within the four bitplanes. 


To write these color values to other locations, you can use additional write 
accesses. No more read accesses are necessary, since the latch registers already 
contain the appropriate values and their contents are not changed by the write 
access. 


Write mode 2 


Write mode 2 resembles a combination of the various modes of write mode 0. As 
in write mode 0, the bitmask register determines which bits will be taken directly 
from the latch registers and which will be modified. The manner in which these 
bits are manipulated is again determined by the mode selected in the Function 
Select register. The lower four bits of the CPU byte will be combined with the 
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latch registers, independent of the Enable Set/Reset register. Bit zero of the CPU 
byte is combined with all bits in latch register zero which are to be modified. The 
same applies for CPU bits 1, 2, and 3, which are combined with the bits of latch 
registers 1, 2, and 3, respectively. 


Latch #0 Latch #1 Latch #2 Latch #3 


LY] — pe? FO ORO0{021 113 COR00/0:081 1 
AUT iit Hit 


| 10=OR Comparison] 
EXE MOPEXIX! 
Function 
select 
register 
OLDER DOLE! 
Byte in: aes #0 Bitplane #1 ee #2 TERITEN #3 


Write access to video RAM in write mode 2 


This mode is good for setting the colors of individual pixels, as we demonstrated 
in the example in write mode 0. In contrast to write mode 0, the assembly- 
language fragment is somewhat shorter because neither the Enable Set/Reset nor 
the Set/Reset register has to be programmed. Here is the same example using write 
mode 2: 


mov ax, OA000h 7segment address of the video RAM 


mov ds, ax zin DS 

xor bx, bx gload offset address 0 

mov al, [bx} zload byte 0 in the latch registers 

mov dx, 3CEh ;port address of the graphics cont. addr. reg. 
mov ax,0205h ;read mode 0, write mode 2 

out dx,ax zwrite into the mode register 

mov ax, 0003h gwrite REPLACE mode (0) in the Function 

out dx, ax ;Select register 

mov ax, 0S508h zwrite the bit mask to the bitmask register 
out dx,ax 

mov al, OBh 7new color value in AL 

mov [bx],al z;and from there to the video RAM and 


zinto the latch regs and bitplanes 


Demonstration program 
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The following program demonstrates the following basic graphics routines: 


° Calculating the position of a pixel within the video RAM 
° Setting the color of a pixel 

° Reading the color of a pixel 

° Filling the entire video RAM with a color 
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If you have followed this section closely, especially the material on the read and 
write modes, you won't have any problems following the logic of the various 
functions. Since it contains detailed documentation, we won't say anything more 
about it. 


It should be noted that the program is intended for demonstration purposes only. 
You can develop it further if you want to make a graphics library out of these 
functions. For example, the function PIXPTR loads the segment address of the 
video RAM into the ES register for calculating the position of a pixel within the 
video RAM each time it is called. This can be eliminated by loading this address 
into the register once at the beginning of the program and leaving it there, as long 
as the other functions do not change this register. 


The graphics controller register programming can also be improved. Here the 
various registers are reloaded with the ROM-BIOS default values after the function 
has completed. This can be eliminated as long as you do not use the BIOS 
functions for character output (in the graphics mode) or the functions for setting 
and testing points within the module or prograrm. If you avoid these calls, then 
these registers can be reset to their default values once at the end of the program 
instead of at the end of each routine. 


Assembler listing: VEGA.ASM 


HK KKK KKK KKK AK KIKI KKK AK KK KK KAKA KEKE KE KEKE KKKEKKEKKKKKKKKEKEK « 


es VEGA bal 
an ct Sc sams is eSnips ek Sak a Sk ah el da a See a cw eas sas es ee ee cos oS so Ks 
rial Task : Creates elementary functions for accessing the *; 
> graphic modes on an EGA/VGA card *s 
3* siya ss asses is a nn Sais coma nab un mths i'm nn i scm mca ef cms Wile Sse {ius oso in kurt es mala Sy ces Scum gs cu ism ‘ps cine ees ma ss na a he os 
ik Author : MICHAEL TISCHER ee 
ae Developed on : 10/3/1988 sass 
he Last update : 6/19/1989 xs 
;* ens sens ices cs ea “cic ls sc es ah eens chest ca “mi Sa css Sa es lnc cad coms meted Ss cs sey nts es em eta see we 
7° Assembly : MASM VEGA; +3 
fe LINK VEGA; *s 
ae ci ms “ea ccc einem a em ans “a av eka cmap ccs avs seus cc aks Sas mw sa cm a a nd lds low Sl SW eel ces es Sess es is es cs es ee ee ce ee ~ 
is Call : VEGA ns 
pK KKK KEKE KKK KER EEK KE KK EEK KRE KEK KEKE KEK KEE KKK EKER KEKE KKK KKKKREKEKKEKKKKE 0 


’ 


7== ConstantS ===s==S=s=ss=sssSssssSSssssnsessssSS ess SSS Se SSeeSSSS====5= 
VIO_SEG = OA000h ;Segment address of video RAM 
zin graphic mode 
LINE LEN = 80 zEvery graphi line in EGA/VGA graphic 
7;modes require 80 bytes 
BITMASK REG = 8 ;Bitmask register 
MODE_REG = 5 ;Mode register 
FUNCSEL REG = 3 7Function select register 
MAPSEL REG = 4 ;Map-Select register 
ENABLE REG = 1 zEnable Set/Reset register 
SETRES REG = 0 ;Set/Reset register 
GRAPH CONT = 3CEh yPort addressd of graphic controller 
OP_MODE = 0 ;Comparison operator mode: 
; OOh = Replace 
; 08h = AND comparison 
' 10h = OR comparison 
; 18h = EXCLUSIVE OR comparison 
GR_640 350 = 10h 7BIOS code for 640x350-pixel 
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716-color graphic mode 
TX_80 25 = 03h ;BIOS code for 80*25-char. 
;text mode 


f== Stack ====ss=ss=sscsssssessssnnsses Sessa sess ssss ses ssn SSsSSSSSsSSsss= 
stack segment para stack ;Definition of stack segment 

dw 256 dup (?) 7256-word stack 
stack ends zEnd of stack segment 
po> Data =ssessessesssssesesse sess sS seers SSS SSS SSS SSS SSS SSS SSS SSS SSS 
data segment para '‘DATA' ;Definition of data segment 
7== Data for the demo program =====ssssssss=sssesssSrsssEsssssSSseSss=e== 


initm db 13,10 

db “VEGA (c) 1988 by Michael Tischer" 

db 13,10,13,10 

db "This demonstration program operates only with an EGA/",13,10 
db "card and a hi-res monitor. If your PC doesn't have this",13,10 
db “configuration, please press the <s> key to abort the",13,10 
db “program.",13,10 

db “Press any other key to start the program.",13,10,"$" 


data ends z7End of data segment 
code segment para 'CODE' 7Definition of code segment 


assume cs:code, ds:data, es:data, ss:stack 


demo proc far 
mov ax,data 7Get segment addr. from data segment 
mov ds,ax yand load into DS 
mov eS,ax yand ES 
7-- Display opening message and wait for input --------------- 
mov ah,9 7;Function number for string display 
mov dx,offset initm ;Message address 
int 21h 7Call DOS interrupt 
xor ah,ah 7Get function number for key 
int 16h 7Call BIOS keyboard interrupt 
cmp al,"s" ;Was <s> entered? 
je ende ;YES --> End program 
cmp al,"Ss" 7;Was <S> entered? 
jne startdemo 7;NO --> Start demo 
ende: mov ax, 4Cc00h 7Function no. for end program 
int 21h 7Call DOS interrupt 21H 


7-- Initialize graphic mode ---------~--------~----------------- 
startdemo label near 


mov ax,GR_640_ 350 zInitialize 64x350-pixel 
int 10h 716-color graphic mode 
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mov ch,000100001b ;Color: Blue 


mov 


call fillscr 


dl: mov 


ine 
cmp 
jne 


mov 
int 
je 


mov 
int 


jmp 


demo endp 


ax, 350 


sNumber of raster lines: 350 
sFill screen 


The program displays two squares on the screens (the —— 
second is really a copy of the first) until the user = 
presses a key to end the program = 


ch, ch 7;Set color to 0 

ax, 100 ;Starting line of first square 
ch ;Increment color 

ch,15 sAND bits 4 and 7 

bx, 245 7Starting column of first square 
setpix 7Set pixel 

cx ;Save color 

getpix ;Get pixel color 

ax sPush coordinates onto stack 
bx 

bx, 100 7;Compute position of second 
ax, 100 7; Square 

setpix 7;Set pixel of copy 

bx ;Return coordinates of first square 
ax 

cx 7Get color 

bx z;Increment column 

bx, 295 7;Reached the last column? 

a3 7NO --> Set next pixel 

ax ;YES, Increment line 

ax, 150 ;Reached the last line? 

d2 ;NO --> Work with next line 
ah,1 ;Read keyboard 

16h 7Call BIOS keyboard interrupt 
di ;No key pressed ~--> Continue 
ax,TX_80 25 780x25 text mode 

10h sInitialization 

short ende 7;End programm 


-- Input : 


, 

' 

7 

"=~ 

7—— Output : 
cc 

— 

=> 

77 

7-- Registers: 


pixptr proc 
push 


mov 
Mov 
mul 
shr 
shr 


~~ PIXPTR: Computes the address of a pixel within video RAM for the - 
~ new EGA/VGA graphic modes 


AX = Graphic line 
BX = Graphic column 
ES:BX = Pointer to the byte in video RAM containing pixel 
CL = Number of right shifts for the byte 
= Number of byte shifts in ES:BX needed to isolate 
the pixel 
AH = Bitmask for combining with all other pixels 
ES, AX, BX and CL are changed 
near 
dx ;Push DX onto stack 
cl,bl ;Save low byte of graphic column 
dx, LINE_LEN ;Number of bytes per line to DX 
dx 7AX = graphic line * LINE LEN 
bx, 1 ;Shift graphic column three places to 
bx, 1 ;the right, divide by 8 
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shr bx,1l 
add bx,ax ;Add line offset 
mov ax,VIO SEG ;Load segment address of video RAM 
mov eS,ax ginto ES 
and cl,7 ;And bits 4 - 7 of graphic column 
xor cl,7 ;Turn bits 0 - 3 then 
;subtract 7 - CL 
mov ah,1l ;After shift, bit 0 should be 
jleft alone 
pop dx ; 7Pop DX off of stack 
ret ;Back to caller 


pixptr endp 


~~ SETPIX: Sets a graphic pixel in the new EGA/VGA graphic modes ------ 


-- Input : AX = graphic line 
-- BX = graphic column 
CH = pixel color 


Output : none 
-- Registers: ES, DX and CL are changed 


Ne Ss Ne Ve Ve Vs 
t 
t 


setpix proc near 
push ax >;Push coordinates onto 
push bx ;the stack 
call pixptr ;Computer pointer to the pixel 
mov dx,GRAPH CONT ;Load port addr. of graphic controller 


z-~ Set bit position in bitmask register --------------------- 


shl ah,cl ;Mask for bit to be changed 
mov al,BITMASK REG ;Move bitmask register from AL 
out dx,ax ;Write to register 


;-~- Set read mode 0 and write mode 2 -- ---------------------- 


mov ax,MODE REG + (2 shl 8) ;Reg. no. and ,mode value 
out dx,ax ;Write in the register 


;-- Define comparison mode between preceding latch ----------- 
y-- contents, and CPU byte (re net a me a ee 


mov ax,FUNCSEL REG + (OP_MODE shl 8) ;Write register number 
out dx,ax ;and comparison operator 


g-~ Pixel Control] eon r wan enn nnn nnn rn rer nnn nn 


mov al,es: [bx] 7;Load latches 
mov es:[bx],ch 7;Move color into bitplanes 


7-- Set altered registers to their default (BIOS) ------------ 
Po- Stats a a ee ee a 


mov ax,BITMASK REG + (OFFh shl 8) ;Set old bitmask 


out dx,ax ;Write in the register 

mov ax,MODE REG ;Write old value for for mode register 
out dx,ax zinto register 

mov ah,FUNCSEL REG ;Write old value for function select 
out dx,ax ;register into register 
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=e @s “Qe BWe Be Bs 


getpix 


pop 


pop 
ret 


endp 
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bx ;Pop coordinates off of stack 
ax : 
;Back to caller 


-~ GETPIX: Places a pixel's color in one of the new EGA/VGA ----------- 


graphic modes 


Output : 
Registers: 


proc 


push 
push 


call 
mov 
shl 


mov 
xor 


mov 
mov 


AX = graphic line 


BX = graphic column 

CH = graphic pixel color 

ES, DX , CX and DI are changed 

near 

ax 7Push coordinates onto 

bx jthe stack 

pixptr ;Computer pointer to pixel 

ch,ah 7Move bitmask to CH 

ch; cr 7Shift bitmask by bit positions 
di,bx 7Move video RAM offset to DI 

bl,bl 7Color value will be computed in BL 
dx, GRAPH_CONT ;Load graphic controller port address 


ax,MAPSEL REG + (3 shl 8) ;Access bitplane #3 


7-- Go through each of the four bitplanes -------------------- 


gpl: out dx,ax sActivate bitplane #AH only 
mov bh,es: [di] 7;Get byte from the bitplane 
and bh,ch ;Omit uninteresting bits 
neg bh 7;Bit 7 = 1, when a pixel is set 
rol bx,1 7;Shift bit 7 from BH to Bit 1 in BL 
dec ah ;Decrement bitplane number 
jge gpl ;Not -1 yet? --> next bitplane 
7-- The map select register must not be reset, since -~ 
7-- the EGA- and VGA-BIOS default to a value of 0 -- 
mov ch,bl 7Get color from CH 
pop bx 7Pop coordinates off 
pop ax z;of stack 
ret 7;Back to caller 
getpix endp 
7-- FILLSCR: Sets all screen pixels to one color ~----<-— ---------------- 
7—-— Input : AX = number of graphic lines on the screen 
i-- CH = pixel color 
77~ Output : none 
7-- Registers: ES, AX, CX, DI, DX and BL are changed 
fillscr proc near 
mov dx,GRAPH CONT ;Load graphic controller port address 
mov al,SETRES_ REG zNumbmer of Set-/Reset registers 
mov ah,ch ;Move bit combination to AL 
out dx,ax 7Write to the register 
mov ax,ENABLE REG + (OFh shl 8) ;Write OFH in the 
out dx,ax zEnable Set~/Reset register 
mov bx,LINE LEN / 2 zLength of a graphic line / 2 into BX 
mul bx 7Multiply by number of graphic lines 
MOV CX,ax 7Move to CX as repeat counter 
xor di,di ;Address first byte in video RAM 
mov ax,VIO SEG 7Segment address of video RAM 
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mov 
cld 
rep 


‘ 


mov 
mov 
out 


ret 


fillscr  endp 


eS, ax 

stosw 

Return old contents 
dx, GRAPH CONT 


ax, ENABLE REG 
dx, ax 


;Load into ES 
;Increment on string instructions 
7;Fill video RAM 


of Enable Set-/Reset register -—-—— 
;Load graphic controller port address 
:Write OOH in Enable Set-/ 


7;Reset register 


;Back to caller 


code ends 


end 
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7End of code segment 
;Start program execution with DEMO 
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10.6 Determining the Type of Video Card 


Whenever you want to access video card hardware or use a BIOS function which is 
only available in special versions of the BIOS, you should first ensure that the card 
in question is actually installed in the system. If your program doesn't make such a 
test, then the result may not be what you wanted to appear on the screen. 


It is especially important for an application program to recognize the type of video 
card installed, if your program is supposed to work the same on all types of cards 
while still directly accessing video hardware. The output routines need this 
information to make optimum use of the special properties of the given card. 


Remember that the PC can have both a monochrome video card (MDA, HGC or 
EGA with a monochrome monitor) and a color video card (EGA, VGA, or CGA) 
installed, although only one of the two cards may be active at one time. 


Combinations allowable for PC video cards 


We need to find out what video cards are installed. There are no BIOS or DOS 
functions for doing this, nor are there any variables we can read. We have to write 
an assembly language routine which checks the existence of different video cards. 
We can refer to the documentation for the various cards, since most manufacturers 
include some procedure for determining if their card is in use. It is important to 
keep the test specific (i.e., it does not return a positive result if a certain type of 
video card is not installed). This presents problems for EGA and VGA cards, which 
can emulate CGA or MDA cards with the appropriate monitor, and are difficult to 
distinguish from true CGA or MDA cards. 


All of the tests described here are found at the end of this section in the form of 
two assembly language programs intended for use with C and Pascal programs. 
The functions place the type of video card installed and the type of monitor 
connected to it into an array to which the function is passed a pointer. If two video 
cards are installed, their order in the array indicates which one is active. 


The following cards can be detected by the assembly language routine: 


° MDA cards 
. CGA cards 
° HGC cards 
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e EGA cards 
e VGA cards 


Since the assembly language routine checks selectively for the existence of a 
certain video card, there is a separate subroutine for each type of video card. It bears 
the name of the video card for which it tests. These routines have names like 
TEST_EGA, TEST_VGA, etc. The tests could be called sequentially, but certain 
tests can be excluded if we know they would return a negative result. This is case 
for the CGA test, for example, if an EGA or VGA card has already been detected 
and is connected to a high-resolution color monitor. A CGA card cannot be 
installed alongside such a card, so there is no point in testing for it. 


There is a flag for each test which determines whether or not the test will be 
performed. Before the first test, the VGA test, all of the flags are set to 1 so that 
all of the tests will be performed in order. During the testing, certain flags can be 
set to 0 for reasons mentioned above, and the corresponding tests will not be made. 


VGA test 
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The tests begin with the VGA test. It is very easy because there is a special 
function in the VGA BIOS, sub-function 00H of function 1AH, which returns 
precisely the information that the assembly language routine needs. The 
information is available only if a VGA card and hence a VGA BIOS is installed. 
This is the case if the value 1AH is found in the AL register after the call. If the 
test routine encounters a different value there, the VGA test will be terminated and 
the other tests will be performed. This indicates that a VGA card is not installed. 


After this function is called, the BL register contains a special device code for the - 
active video card and the BH register contains a code for the inactive card. The 
following codes can occur: 


1OOH | No video card 
MDA card/monochrome monitor 

lo2H | CGA card/color monitor 
O3H__ | Reserved 


02H 
03H 
lO6H_ | Reserved 


These codes are separated into values for the video card and the monitor connected 
to it, and loaded into the array whose address is passed to the assembly language 
routine. Since this routine already has information about both video cards, the 
following tests do not have to be performed. The routine executes the monochrome 
test, however, if the functions discover a monochrome card, since it cannot 
distinguish between an MDA and HGC card. 


Abacus 10.6 Determining the Video Card Type 


EGA test 


After the VGA test comes the EGA test, which it performed only if the VGA test 
was unsuccessful, and thus the EGA flag was not cleared. It uses a function which 
is found only in the EGA BIOS: sub-function 10H of function 12H. If no EGA 
card is installed and this function is not available, the value 10H will still be found 
in the BL register after the function call. In this case the EGA test ends. 


If an EGA card is installed, the CL register will contain the settings of the DIP 
switches on the EGA card after the call. These switches indicate what type of 
monitor is connected. They are converted to the monitor codes the assembly 
language routine uses and placed in the array along with the code for the EGA card. 
The CGA or monochrome test flag is cleared depending on the type of monitor 
connected. The EGA routine ends. 


CGA test 


If the CGA flag has not been cleared by the previous tests, the CGA test follows 
the EGA test. As with the monochrome test, there are no special BIOS functions 
which can be used and we have to check for the presence of the appropriate 
hardware. In both routines this is done by calling the routine TEST_6845, which 
tests to see if the 6845 video controller found on these cards is at the specified port 
address. On a CGA card this is port address 3D4H, which is passed to the routine 
TEST_6845. 


The only way to test the existence of the CRTC at a given port address is to write 
some value (other than 0) to one of the CRTC registers and then read it back 
immediately. If the value read matches the value written, then the CRTC and thus 
the video card are present. But before writing a value into a CRTC register, we 
should stop to consider that these registers have a major impact on the 
construction of the video signals and careless access to them can not only 
thoroughly confuse the CRTC, it can even harm the monitor. Registers 0 to 9 are 
out of the question for this test, leaving us with registers 10 to 15, all of which 
have an effect on the screen contents. The best we can do is registers 10 and 11, 
which control the starting and ending lines of the cursor. 


The assembly language routine first reads the contents of register 10 before it loads 
any value into this register. After a short pause so that the CRTC can react to the 
output, the contents of this register are read back. Before the value read is compared 
to the original value, the old value is first written back into the register so that the 
test disturbs the screen as little as possible. If the comparison is positive, then a 
CRTC is present and so is the video card (CGA in this case). The CGA routine 
responds by loading the code for a color monitor into the array, since this is the 
only type of monitor which can be used with a CGA card. 
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Monochrome test 


The last test is the monochrome test, which also checks for the existence of a 
CRTC, this time at port address 3B4H. If it finds a CRTC there, then a 
monochrome card is installed and we have to figure out if it is an MDA or HGC 
hard. The status registers of the two cards, at port address 3BAH, are used to 
determine this. While bit 7 of this register has no significance on the MDA card 
and its value is thus undefined, it contains a 1 on an HGC card whenever the 
electron beam is returning across the screen. Since this is not permanent and 
occurs only at intervals of about two milliseconds, the contents of this bit 
constantly alternates between 0 and 1. 


Hercules 


The test routine first reads the contents of this register and masks out bits 0 to 6. 
The resulting value is used in a maximum of 32768 loop passes, where the value 
is read again and compared with the original value. If the value changes, meaning 
that the state of bit 7 changes, then an HGC card is probably installed. If this bit 
does not change over the course of 32768 loop passes, then an MDA card is in 
use. 


Here again we place the appropriate code for the video card in the array. The 
monitor code is also set to monochrome, since this is the only monitor which can 
be connected to an MDA or HGC card. 


Primary and secondary video systems 
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The tests are now over. Now we have to figure out which card is active (primary) 
and which is inactive (secondary). If the outcome of the VGA test was positive, we 
can skip this because the VGA BIOS routine determines the active card 
automatically. 


In other cases we can determine the active video card from the current video mode, 
which can be read with the help of function OFH of the BIOS video interrupt. If 
the value seven is returned, then the 80x25 text mode of the monochrome card is 
active. All of the other modes indicate that a CGA, EGA, or VGA card is active. 
This information is used to exchange the order of the two entries in the array if it 
does not match the actual situation. | 


The assembly language routine returns control to the calling program. 


Here we include C and Pascal programs which call the function GetVIOS from the 
assembly language module, and demonstrate how Get VIOS works. 
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C listing: VIOSC.C 


[RRR KKEKEK KEKE KKK ERE KEKE EEK KEKE KEKEKEKEKKEEKEEKEKKKEKEKKKEKKKKE / 


/* VIosc */ 
/* iss Gm sis eit Sea, ct rm Sis cen ‘ta ese Si ec cm in en iss mG, c's ci mys cs cp’ cam ea i'n ci ce ee Us em lem os se bn tse ce enn in stn cats cin une iss */ 
{[? Task : Determines the type of video card and monitor */ 
/* installed in the system. itd 
/* ‘Ss an Snes eps sists ca es us ap sm oem mmm tus cy ep sn ans exes ie las ib cs Gen SD eu ‘ns “ni tne Qo Gsm sims es cub Su a ais ls nme eb Cs msde eis Ge es ees nme es Ga wk ed en em */ 
/* Author : MICHAEL TISCHER */ 
/* Developed on : 10/02/1988 */ 
/* Last update : 06/20/1988 */ 
/* “a ssi sic evs ss ci isc lp cms sels ecient Gu em Cd a cs C's cs nin Sn cass cen ms Sls issues sin Sn int ens in Gms mu hes cts msi ld nh, */ 
rg (MICROSOFT C} ay 
/* Creation : CL /AS /c VIOSC.C */ 
/* LINK VIOSC VIOSCA a 
/* Call : VIOSC a 
/* Ge Sw Sa ei cs Svs eases en nr an in ncn es evs nah lis eee es “eu Sis its scm iu‘ ce na ei ins cw cia nach eb ees ‘ama i Ses ep cs Oo ah Sn te Oem Sl ee Gls oe Sow Ges x/ 
/* (BORLAND TURBO C) ia 
/* Creation : Create project file made of the following: a 6 
7% VIOSC */ 
/* VIOSCA. OBJ */. 
/* Info : Some cards may return errors or “unknown" Ly A 


[RRR KKK KIKI II KIRK KIKI KKK IKI K IK AKIK KIA KIKI EE KAEEAKEIAKK IK IK / 


/*== Declarations of external functions ======s=sss==ssesses2s22sssss2====t / 


extern void get_vios( struct vios * ); 


{t== Type de fs SSS SSS SSS SS SSS SE Se ESSE SSS / 
typedef unsigned char BYTE; /* Create a byte */ 
/*== Structures SLI Ss SSeS SE ee SEES St / 
struct vios { /* Describes video card and attached monitor */ 

BYTE vcard, 

monitor; 

}e 

/*-~ Constants for the video card ~--------------------- 3 */ 


#define NO VIOS 0 /* No video card */ 
#define VGA 1 /* VGA card */ 
#define EGA 2 /* EGA card */ 
#define MDA 3 /* Monochrome Display Adapter */ 
#define HGC 4 /* Hercules Graphics Card */ 
#define CGA S /* Color Graphics Adapter */ 


/*-- Constants for monitor type --------------- 99 ne */ 
#define NO MON 0 /* No monitor */ 
#define MONO 1 /* Monochrome monitor */ 
#define COLOR 2 /* Color monitor */ 
#define EGA_HIRES 3 /* High-res/multisyne monitor */ 
#define ANLG MONO 4 /* Analog monochrome monitor */ 
#define ANLG COLOR 5 /* Analog color monitor */ 


[RRR IERIE IKEA IRE IKI IKKE IARI IKKE KEARKERKAKEEEAAKA KK KKK | 


fue MAIN PROGRAM sl 


[RRR EKER EERIE III KK ITI IKARIA IKK / 
void main() 

{ 

static char *vcnames[] = { /* Pointer to the video card name */ 


"VGA", 
“EGA", 


541 


10. Accessing and Programming the Video Cards PC System Programming 


static char *monnames[] = { /* Pointer to the monitor type's name */ 
“monochrome monitor", 
“color monitor", 
“high-res/multisync monitor", 
"analog monochrome monitor", 
“analog color monitor" 
}; 


struct vios vsys[2]; /* Vector for GET_VIOS */ 


get_vios( vsys ); /* Determine video system */ 
printf ("\nVIOSC (c)} 1988 by Michael Tischer\n\n") ; 
printf ("Primary Video System: %s card/ %s\n", 
venames([vsys[(0].vcard-1], monnames[vsys[0] .monitor-1]); 
if ( vsys[{1}.vcard != NO VIOS ) /* Is there secondary video system? */ 
printf (“Secondary Video System: %s card/ %s\n", 
vcnames [vsys[1].vcard-1], monnames[vsys[1] .monitor-1]); 


Assembler listing: VIOSCA.ASM 
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KHKKKEKKEKKKEIKK KEKE KEKE KK KEKE EEK KK ERE KEK KKK KK KKK KKEKKKKEKKKE oO 


ox 

¢ cA 
;* VIOSCA he 
rial E65 ows ee ces ses end thes ils ems ams mes eis ita sess Go Cis cas wad i in ua mies eb cas cms ced aes "Sns ns un ed cms sus aes aes snus ea sms cao no ees mw saps ome eae asl ui cee eo’ Gs ine es a a =; 
ies Task : Creates a function for determining video * 
eel adapter and monitor type, when linked with +s 
Pa! a C program. 5 
ax cis Se es Sas as ibs cs ames em ms en sen mss as rs rs eas ees cas “a ses i Seas as Ss ence a a ee ee a a a es on a a ewe eee oe xe 
-* Author : MICHAEL TISCHER x; 
ok Developed on : 10/02/1988 *s 
;* Last update : 06/20/1989 *; 
ok LE A AN OEY EE ND END SD A GT NS A A OS SE ES ETS ND SN ERNE EN SED ES gD GA SED Ae GED AED SEED NN Gy NS GUE TS SD SED OD ED EG ED SD GD AP SOY SEED ED Mey END ENE GER EY GES GEE SS OY te 
tf v 
ae Assembly : MASM VIOSCA; xe 
* ... link to a C program * 
RHKKKKKKKEKK KEKE KIER IK HEKK KKK EKER KKK IKK RE KKK KEE KKK EKER KKK KKK KKEKKEKRKEKK 0 


;Video card constants 


NO _VIOS = 0 7No video card 
VGA =] 7VGA card 
EGA = 2 7;EGA card 
MDA = 3 7;Monochrome Display Adapter 
HGC = 4 ;Hercules Graphics Card 
CGA = 5 7Color Graphics Adapter 
;Monitor constants 
NO_MON = 0 ;No monitor 
MONO =] ;Monochrome monitor 
COLOR = 2 7Color monitor 
EGA_HIRES = 3 ;High-resolution or multisync monitor 
ANLG MONO = 4 zAnalog monochrome monitor 
ANLG COLOR = 5 ;Analog color monitor 
7;== Segment declarations for the C program ===========s====s===s===s=s==s=s=== 
IGROUP group text zAddition to program segment 


DGROUP group const, bss, —_data ;Addition to data segment 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public ‘CONST';This segment includes all read-only 
CONST ends 7constants 


_BSS segment word public 'BSS' ;This segment includes all 
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_BSS ~~ ends 


_DATA segment 


word public ‘DATA’ 


sun-initialized static variables 


7;Data segment 


Conversion table for return values of function 1AH, --- 
sub-function OOH of the VGA-BIOS --- 


7No video card 

7MDA card and monochrome monitor 
;CGA card and color monitor 

7;Code 3 unused 

;EGA card and hi-res monitor 

;EGA card and monochrome monitor 
7Code 6 unused 

7VGA card and analog mono monitor 
;VGA card and analog color monitor 


Conversion table for EGA card DIP switch settings ------- 


vios tab equ this byte 

-== 

db NO VIOS, NO MON 

db MDA , MONO 

db CGA , COLOR 

db ? ee 

db EGA , EGA_HIRES 

db EGA , MONO 

db ? 2 

db VGA =, ANLG MONO 

db VGA _—s,_ ANLG COLOR 
ega dips equ this byte 

db COLOR, EGA_HIRES, MONO 

db COLOR, EGA HIRES, MONO 
_DATA ends 


It 
i 
It 
it 
H 


_TEXT segment byte public ‘CODE' ;Program segment 


public 


_get 


_vios 


7-- GET VIOS: Determines types of installed video cards --~--~----------- 
j-- Call from C 


;-- Info 
_get_vios 


sframe 
cga_ possi 
ega_possi 
mono_possi 
bptr 

ret adr 
vp 

sframe 


frame 


2-— Declaration 
-- Return value 


proc 


stru 


dw ? 
dw ? 
ends 


equ 


push 
sub 
mov 
push 


mov 
mov 
mov 


mov 
mov 
mov 


call 
cmp 


je 


none 


near 


Cc 


{ bp - cga possi ] 


bp 
sp,3 
bp, sp 
di 


frame.cga_possi,1 
frame.ega_possi,1 


frame.mono_ possi,1 


di, frame.vp 


: void get_vios( struct vios *vp ); 
struct vios { BYTE vcard, monitor; }; 


This example uses function in SMALL memory model 


;Stack access structure 

;Local variable 

;Local variable 

;Local variable 

7;Take BP 

;Return address to caller 
sPointer to first VIOS structure 
z;End of structure 


;Address elements of the structure 


7Push BP onto stack 
sAllocate space for local variables 
;Transfer SP to BP 
7;Push DI onto stack 


7;Could be CGA 
7;Could be EGA 
7;Could be MDA or HGC 


7Get offset address of structure 


word ptr [di],NO VIOS 7;Still no video 
word ptr [di+2],NO VIOS ;system found 


test_vga 
frame.ega_possi,0 
gvl 


7;Test for VGA card 
7;EGA card still possible? 
7;NO ~-> Test for CGA 
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call test_ega 7Test for EGA card 
gvl: cmp frame.cga_possi,0 ;CGA card still possible 
je gv2 3;NO --> Test for MDA/HGC 
call test _cga ;Test for CGA card 
gv2: cmp frame.mono_possi,0;MDA or HGC card still possibleh? 
je gv3 ;NO --> End tests 
call test_mono 7Test for MDA/HGC cards 
7-- Determine active video card ----------<----<9- =< --- 
gv3: cmp byte ptr [di],VGA ;VGA card active? 
je gvi_end 7YES, active card already determined 
cmp byte ptr [di+2],VGA ;VGA card as secondary system? 
je gvi_end 7YES, active card already determined 
mov ah,OFh ;Determine active video mode using the 
int 10h 7BIOS video interrupt 
and al,?7 7;Only modes 0-7 are of interest 
cmp al,7 ;Monochrome card active? 
jne gv4 7;NO, in CGA or EGA mode 


;-~ MDA, HGC, or EGA card (mono) is active -----------~------ 
cmp byte ptr [di+1],MONO ;Mono monitor in first structure? 
je gvi_end 7YES, Sequence o.k. 

jmp short switch 7NO, Change sequence 


7-- CGA or EGA card currently active ------------------------ 


gv4: cmp byte ptr [di+1],MONO ;Mono monitor in first structure? 
jne gvi_end 7;NO, Sequence o.k. 

switch: mov ax, [di] 7Get contents of first structure 
xchg ax, [di+2] z7Exchange with second structure 


mov {di],ax 


gvi_end: pop di ;Get DI from stack 
add_ sp,3 7Get local variables from stack 
pop bp 7;Get BP from stack 
ret 7Return to C program 


_get_vios endp 


;-- TEST VGA: Determines whether a VGA card is installed 


test_vga proc near 


mov ax, 1a00h 7Function 1AH, sub-function OOH 
int 10h 3;calls VGA-BIOS 

cmp al,lah zIs this function supported? 
jJne tvga_end 7NO --> End routine 


;-- If function is supported, BH contains the active video -- 
77- system code; BH contains the inactive video sys. code -- 


mov cx, bx 7Move result to CX 

xor bh,bh 7;Set BH to 0 

or ch, ch 7Just one video system? 

je tvgal 7YES --> Convey first system's code 


;—-—- Convert code of second system --------------------------- 


mov bl,ch 7Move second system code to BL 
add bl,bl ;Add offset to table 
mov ax,offset DGROUP:vios tab[bx] ;Get code from table and 
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mov [di+2],ax zplace in caller's structure 

mov bl,cl ;Move first system's codes to BL 

7~- Convert code of first system --<---3------ nnn 
tvga_1: add pbl,bl ;Add offset to table 

mov ax,oOffset DGROUP:vios tab[bx] ;Get code from table and 

mov [di],ax splace in caller's structure 


mov frame.cga_possi,0O ;CGA test failed 
mov frame.ega_possi,0 ;EGA test failed 
mov frame.mono possi,0 ;MONO still needs testing 


mov bx,di ;Address of active structure 
cmp byte ptr [bx],MDA ;Monochrome system available? 
Je do _tmono 7YES --> Execute MDA/HGC test 
add bx,2 sAddress of inactive structure 
cmp byte ptr [bx],MDA ;Monochrome system available? 
jne tvga_end 7NO --> End routine 


do_tmono: mov word ptr [bx],0 ;Pretend that this system 
zis still unavailable 
mov frame.mono_possi,1;Execute monochrome test 
tvga_end: ret ;Back to caller 


test_vga endp 


~~ TEST EGA: Determines whether an EGA card is installed 


test_ega proc near 


mov ah,12h sFunction 12H 

mov bl,10h 7Sub-function 10H 

int 10h 7Call EGA-BIOS 

cmp bl,10h sIs the function supported? 
je  tega_end 7;NO --> End routine 


z-- When this function is supported, CL contains the EGA ---- 
z~-- card's DIP switch settings areas 


mov al,cl ;Move DIP switch settings to AL 
shr al,l 7Shift one position to the right 
mov bx,offset DGROUP:ega_dips ;Offset address of table 
xlat ;Move element AL from table to AL 
mov ah,al ;Move monitor type to AH 

mov al,EGA sIt's an EGA card 

call found _it ;Move data to vector 

cmp ah,MONO ;Connected to monochrome monitor? 
je is_mono 7;YES --> not MDA or HGC 


mov frame.cga_possi,0O ;Cannot be a CGA card 
jmp short tega_end ;End routine 


is mono: mov frame.mono_possi,0;If EGA card is connected to a mono 
smonitor, it can be installed as 
seither an HGC or MDA 


tega_end: ret 7;Back to callerr 


test_ega endp 


z-- TEST CGA: Determines whether a CGA card is installed 


test_cga proc near 


545 


10. Accessing and Programming the Video Cards PC System Programming 


mov dx, 3D4h 7;CGA tests port addr. of CRIC addr. 
call test_6845 zreg., to see if 6845 is installed 
jc tega_end 7NO --> End test 

mov al,CGA 7YES --> CGA is installed 

mov ah,COLOR sCGA has color monitor attached 
jmp found it ;Transfer data to vector 


7-~- TEST MONO: Checks for the existence of an MDA or HGC card 


test_mono proc near 


mov dx,3B4h 7Check port address of CRTC addr. reg. 

call test _ 6845 zwith MONO to see if there's a 6845 
zinstalled 

jc tega_end 7NO --> End test 


7-- If there is a monochrome video card installed, the ------ 
7-- following determines whether it's an MDA or an HGC ------ 


mov dl,0OBAh 7Read MONO status port using 3BAH 
in al,dx : 

and al,80h 7Check bit 7 only and 

mov ah,al move to AH 


;-- If contents of bit 7 change during one of the following - 
j-- readings, the card is handled as an HGC - 


mov cx, 8000h ;Maximum of 32768 loop executionse 
test_hgc: in al,dx ;Read status port 

and al1,80h 7Check bit 7 only 

cmp al,ah ,Contents changed? 

jne is _hgc 7;Bit 7 = 1 --> HGC 

loop test_hgce 7;Continue loop 

mov al,MDA ;Bit 7 <> 1 --> MDA 

jmp set_mono. ;Set parameters 
is_hge: mov al,HGC ;Bit 7 = 1 --> ist HGC 
set_mono: mov ah,MONO 7MDA/HGC on mono monitor 

jmp found it ;Set parameters 


test_mono endp 


7-- TEST 6845: Sets carry flag if no 6845 exists in port address of DX 


test_6845 proc near 


mov al,0OAh ;Register 10 

out dx,al ;Register number of CRTC address reg. 

inc dx 7DX now in CRTC data register 

in al,dx 7Get contents of register 10 

mov ah,al zand move to AH 

mov al,4Fh 7Any value 

out dx,al ;Write to register 10 

mov cx,100 ;Short delay loop--gives 6845 time 
wait: loop wait ;to react 

in al,dx ;Read contents of register 10 

xchg al,ah ;Exchange AH and AL 

out dx,al 7Send old valuen 

cmp ah,4Fh ;Written value read? 
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je  t6845 end 7YES --> End test 
stc 7;NO --> Set carry flag 
t6845 end: ret 7Back from caller 


test _ 6845 endp 


gv 
;-- FOUND_IT: Transfers video card type to AL and monitor type to ----- 
asa AH in the video vector 42 eee 


found _it proc near 
mov bx, di sAddress of active structure 
cmp word ptr [bx],0 7Video system already onboard? 
je set_data 7NO --> Data in active structure 
add bx, 2 7YES, Address of inactive structure 
set data: mov [bx],ax 7;Place data in structure 
ret ;Back to caller 


found it endp 


_text ends 7End of code segment 
end 7End of program 


Pascal listing: VIOSP.PAS 


{ KRHA KERR EK IR RRR RIK KRIEK RRR KERIKERI AKER KEKE AEKAEREREEREKEKEEE | 


{* VIOSP “} 
(¥en See a ee a ee ee ete ee eee eee *} 
{* Task : Returns the type of video card installed. i 
{* a ae ae ee ee ee ese ae es ne ue ee ne a ee a a cD OD ene se ne Se ee SAD A SE SOD ene OD SD Se A PS SE aS Se eS cs sane ee *} 
{* Author : MICHAEL TISCHER | 
{* Developed on : 10/02/1988 *} 
Ba Last update : 06/19/1989 *} 
{* Sti eee ere eee Sea a ee a aa ee ee *} 
{* Info : Some of the values given here may not coincide *} 
Gx with some video cards (e.g., some CGA cards *t 
1 may return “Unknown card"). =} 


{ RA RRK RE RHEKEK EERE EKER EKER EEEKEKKRE REE KREREREREKREKEREERKREEKRKEKEEEKKEKREKREKE | 


program VIOSP; 


{$L c:\masm\viospa } { Link assembler module } 
{ Change path to suit your DOS needs } 
const NO VIOS = 0; { No video card } 
VGA = 1]; { VGA card } 
EGA = 2; { EGA card } 
MDA = 3; { Monochrome Display Adapter } 
HGC = 4; { Hercules Graphics Card } 
CGA = 5; { Color Graphics Adapter } 
NO_MON = 0; { No monitor } 
MONO = ls { Monochrome monitor } 
COLOR = 25 { Color monitor } 
EGA HIRES = 3; { High-resolution monitor } 
ANLG MONO = 4; { Monochrome analog monitor } 
ANLG COLOR = 5; { Color analog monitor } 
type Vios = record { Describes video card and attached monitor } 
vCard, 
Monitor : byte; 
end; 
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ViosPtr = “Vios; { Pointer to a VIOS structure } 
procedure GetVios( vp : ViosPtr }) ; external ; 


var VidSys : array[1..2] of Vios; { Array containing video structures } 


{ REKKKKKKEKKKKKEKKKKKEKEKEKKEKK KKK KEKKE KEKE EKER EK KKEKEK KEK EKREKEKREKKEREKRERKEKKEKEKKEE | 


{* PrintSys: Gives information about a video system *} 
{* Input : ~ VCARD: Code number of the video card *} 
{* ~ MON : Code number of the attached monitor *} 
{* Output : none *} 


{ BARKER AEKKEKKKKKEKEKKEKREK EKER KIRKE KKK KIRKE EKER UEKEKRERKEKEKKKEKKE | 


procedure PrintSys( VCard, Mon : byte ); 


begin 

write(' '); 

case VCard of 
NO VIOS : write (‘Unknown'); { For “other" code } 
VGA : write(‘VGA'); 
EGA : write('EGA'); 
MDA : write('MDA'); 
CGA : write('CGA'); 
HGC : write('HGC'); 

end; 


write(' card/ '); 
case Mon of 


NO MON : write (‘unknown monitor'); { For “other" monitors } 
MONO : writeln (‘monochrome monitor'); 
COLOR : writeln('color monitor'); 
EGA HIRES : writeln('high-resolution monitor') ; 
ANLG MONO : writeln('monochrome analog monitor'); 
ANLG COLOR : writeln(‘color analog monitor'); 
end; 
end; 


{THRE KARKERERKERKERK KKK EREK KKK KK ERKKEKEKKEK KEKE EK KEKERKEKKKEKREKKKKKKKKKS | 


{** MAIN PROGRAM ai | 
[FRR I III II IIR II ICO IOI TORII TCR ROR RIOR ITA IR TORK KAA AK KAA } 


begin 
GetVios( @VidSys ); { Check installed video card } 
writeln('VIOSP - (c) 1988 by MICHAEL TISCHER'); 


write (‘Primary video system: '); 
PrintSys( VidSys[1].VCard, VidSys[1].Monitor ); 


writeln (#13410) ; 
if vidSys[2].VCard <> NO VIOS then { Second video system installed? } 
begin { YES } 


write ('Secondary video system:'); 
PrintSys( VidSys[2].VCard, VidSys[2].Monitor }; 
writeln (#13410); 
end; 
end. 


Assembler listing: VIOSPA.ASM 
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SHKKKKKKAKKKEKKKEKKKKEKKKKKEKKEKKEKEKKKEKEKKKKKKEKEKEKKEKKEKKKKEKEKKKKEKEEKKKKKK 


tf t 
i* VIOSPA ts 
s Ss ni si nk ky ple nts Sm i eps ts ss nie ne s'il we cm i si: sens sn So is i sil sb le i in eis ei oh ‘sii Sth re xs 
a Task : Creates a function for determining the type aa 
= of video card installed on a system. This x: 
ze routine must be assembled into an OBJ file, * 
-* then linked to a Turbo Pascal (4.0) program. ae 
oe Ses a om cans Ss Sst cee ees ssc co us em es ci rs se sic in Teas oc oak Sc nas wa cna no nso os tus ee mn eis Gs a Sas chs ess ct sma ahs te tiie er ca cin wt bald 
ee Author : MICHAEL TISCHER xs 
Pf Developed on : 10/02/1988 *F 
= Last update : 06/19/1989 <3 
;* St: sa wap ec we i inh si Sia, eis i si: te i ets ii ei seis ta ei ei se ti eli ii es et ss’ ies ni a tl ie nan i cen ii iy in lt ip em a buds 
:* assembly : MASM VIOSPA; *; 
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;* ..-. Link to a Turbo Pascal program *s 
:* using the {SL VIOSPA} compiler directive *; 


RAKE AKRKKEKKEKKKEK AREER KE AKK EEK AKER KEKE IKEA EKER EEK EREKEAKKEKEE 9 


7Video card constants 


NO VIOS = 0 7No video card/unrecognized card 
VGA =] ;VGA card 
EGA = 2 ;EGA card 
MDA = 3 sMonochrome Display Adapter 
HGC = 4 ;Hercules Graphics Card 
CGA = 7Coler Graphics Adapter 
sMonitor constants 
NO_ MON = 0 7No monitor/unrecognized code 
MONO = ] ;Monochrome monitor 
COLOR = 2 ;Color Monitor 
EGA HIRES = 3 ;High-resolution/multisync monitor 
ANLG MONO = 4 ;Monochrome analog monitor 
ANLG COLOR = 5 7Analog color monitor 
DATA segment word public ;Turbo data segment 
DATA ends 
CODE segment byte public ;Turbo code segment 
assume cs:CODE, ds:DATA 
public getvios 


7-- Initialized global variables must be placed in the code segment ---- 
vios tab equ this word 


7-- Conversion table for supplying return values of VGA ---- 
7-- BIOS function 1A(h), sub-function 00 (h) aaa 


db NO VIOS, NO MON ;No video card 

db MDA , MONO 7MDA card/monochrome monitor 
db CGA , COLOR 7;CGA card/color monitor 

db ? 1 2 7;Code 3 unused 

db EGA , EGA_HIRES ;EGA card/hi-res monitor 

db EGA , MONO 7EGA card/monochrome monitor 
db ? eas ;Code 6 unused 


db VGA , ANLG MONO ;VGA card/analog mono monitor 
db VGA , ANLG COLOR ;VGA card/analog color monitor 


ega_ dips equ this byte 
3-- Conversion table for EGA card DIP switches ----- 


db COLOR, EGA HIRES, MONO 
db COLOR, EGA_HIRES, MONO 


-- GETVIOS: Determines type(s) of installed video card(s) ------------- 
Pascal call : GetVios ( vp : ViosPtr ); external; 

-- Declaration : Type Vios = record VCard, Monitor: byte; 

Return Value: None 


™e “Wo Be Re 


getvios proc near 


sframe struc ;Stack access structure 
cga_ possi db ? ;local variables 
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nw 


jlocal variables 
jlocal variables 


ega_ possi db 
mono possi db 


nw 


bptr dw ? 7 BPTR 
ret_adr dw ? ;Return address of calling program 
vp dd ? 7Pointer to first VIOS structure 
sframe ends 7End of structure 
frame equ [ bp - cga_possi ] ;Address elements of structure 
push bp 7Push BP onto stack 
sub sp,3 ;Allocate memory for local variables 
mov bp,sp 7Transfer SP to BP 


mov frame.cga possi,1 ;Is it a CGA? 
mov frame.ega_possi,1 ;Is it an EGA? 
mov frame.mono possi,1;Is it an MDA or HGC? 


mov di,word ptr frame.vp 7Get offset addr. of structure 
mov word ptr [di],NO VIOS 7;No video system or unknown 
mov word ptr [di+2],NO VIOS ;system found 


call test_vga 7Test for VGA card 
cmp frame.ega possi,O ;Or is it an EGA card? 
je gvil 7NO -->Go to CGA test 
call test_ega 7Test for EGA card 
gvl: cmp frame.cga_possi,O ;Or is it a CGA card? 
je gv2 7NO --> Go to MDA/HGC test 
call test _cga 7;Test for CGA card 
gv2: cmp frame.mono_possi,0;Or is it an MDA or HGC card? 
je gv3 7NO --> End tests 
call test_mono ;Test for MDA/HGC card 
;~- Determine video configuration ------------~-------------- 
gv3: cmp byte ptr [di],VGA ;VGA card? 
je gvi_end 7YES --> Active card already indicated 
cmp byte ptr [di+2],VGA;VGA card part of secondary system? 
je gvi_end 7YES --> Active card already indicated 
mov ah,OFh ;Determine video mode using BIOS video 
int 10h ;interrupt 
and al,7 7Only modes 0-7 are of interest 
cmp al,7 7Mono card active? 
jne gv4 7;NO --> CGA or EGA mode 


7~~- MDA, HGC or EGA card (mono) currently active ------------ 
cmp byte ptr [di+l],MONO ;Mono monitor in first structure? 
je  gvi_end 7YES, Sequence o.k. 

jmp short switch 7NO, Switch sequence 


7~~- CGA or EGA card currently active --~--------------------- 


gv4: cmp byte ptr [di+l],MONO ;Mono monitor in first structure? 
jne gvi_end 7;NO -->Sequence o.k. 

switch: mov ax, [di] ;Get contents of first structure 
xchg ax, [di+2] ;Switch with second structure 
mov [di},ax 

gvi_end: add _ sp,3 7Add local variables from stack 
pop bp 7Pop BP off of stack 
ret 4 7Clear variables off of stack; 


7Return to Turbo 
getvios endp 
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;-- TEST VGA: Determines whether a VGA card is installed 


test _ vga proc near 


mov ax,1la00h 7;Function 1A(h), sub-function 00 (h) 
int 10h 7;Call VGA-BIOS 

cmp al,lah 7Function supported? 

jne tvga_end 7;NO --> End routine 


j-- If function is supported, BL contains the code of the --- 
z-- active video system, while BH contains the code of << 
s-- the inactive videc system ee 


mov cx, bx 7Move result in CX 

xor bh,bh 7;Set BH to 0 

or  ch,ch ;Only one video system? 

je tvgal 7YES --> Display first system's code 


#-- Convert code of second system ——--—--------------—--—-—---—- 


mov bl,ch 7Move second system's code to BL 
add bl,bl ;Add offset to table 

mov ax,vios tab[bx] 7Get code from table and move into 
mov {dit+2],ax ;caller's structure 

mov bl,cl ;Move first system's code into BL 


77~ Convert code of second sSysteM ~---<<~---9---- eer 


tvga_l: add bl,bl 7Add offset to table 
mov ax,vios tab[bx] ;Get code from table 
mov [di],ax sand move into caller's structure 


mov frame.cga_possi,0O ;CGA test fail? 
mov frame.ega_possi,0 ;CGA test fail? 
mov frame.mono_possi,0O ;Test for mono 


mov bx,di 7Address of active structure 
cmp byte ptr [bx],MDA ;Monochrome system online? 

je do tmono 7YES --> Execute MDA/HGC test 
add bx,2 ;Address of inactive structure 
cmp byte ptr [{bx],MDA ;Monochrome system online? 

jne tvga_end 7;NO --> End routine 


do tmono: mov word ptr [bx],0 7Emulate if this system 
zisn't available 
mov frame.mono_possi,1;Execute monochrome test 
tvga_end: ret 7;Return to caller 


test_vga  endp 


Fe ee ee ae Ee ED CS NE A ED SS ST ED SS SE SN OD TS SE SEU SN SE I TE SD SS GE SS NEY TE SE OES AED GE SS ST CAD SE SD MN SY SNS SS ES SS SEND SY SNE SD EY SD GENIE GT GN CD SOD NN MD SDE RS Se 


;-- TEST EGA: Determine whether an EGA card is installed 


test_ega proc near 


mov ah,12h 7Function 12 (h) 

mov bl,10h 7;Sub-function 10 (h) 

int 10h 7Call EGA-BIOS 

cmp bl,10h ;Is this function supported? 
je tega_end 7NO --> End routine 


;-- If the function IS supported, CL contains the =-S= 
7~- EGA card DIP switch settings om 


mov bl,cl 7Move DIP switches to BL 
shr bl,1l ;Shift one position to the right 
xor bh,bh zIndex high byte to 0 
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mov ah,ega_dips[bx] ;Get element from table 


mov al,EGA zIs it an EGA card? 

call found_it ;Transfer data to the vector 
cmp ah,MONO ;Mono monitor connected? 

je is_ mono 7;YES --> Not MDA or HGC 


mov frame.cga_possi,0 ;No CGA card possible 
jmp short tega_end 7End routine 


is_mono: mov frame.mono_possi,0;EGA can either emulate MDA or HGC, 
71f mono monitor is attached 


tega_end: ret ;Back to caller 


test_ega endp 


77~ TEST_CGA: Determines whether a CGA card is installed 


test_cga proc near 


mov dx, 3D4h 7;Port addr. of CGA's CRTC addr. reg. 
call test_6845 7Test for installed 6845 CRTC 

jc tega_end 7;NO --> End test 

mov al,CGA 7YES, CGA installed 

mov ah,COLOR 7;CGA uses color monitor 

jmp found it 7Transfer data to vector 


7~- TEST MONO: Checks for MDA or HGC card 


test_mono proc near 


mov dx, 3B4h 7Port addr. of MONO's CRTC addr. reg. 
call test _ 6845 7;Test for installed 6845 CRTC 
jc tega_end ;NO --> End test 


s-- Monochrome video card installed 2 tame 


e 


mov dl,OBAh 7;MONO status port at 3BA(h) 
in al,dx 7;Read status port 

and al,80h 7Separate bit 7 and 

mov ah,al 7move to AH 


;-- If the contents of bit 7 in the status port change ---- 
7-- during the following readings, it is handled as an ---- 


on HGC co ee oo oom 
mov cx, 8000h 7maximum 32768 loop executions 
test_hgc: in  al,dx 7;Read status port 
and al,80h zIsolate bit 7 
cmp al,ah 7;Contents changed? 
jne is_hge 7Bit 7 = 1 --> HGC 
loop test_hgc 7 Continue 
mov al,MDA 27Bit 7 <> 1 --—> MDA 
jmp set_mono 7;Set parameters 
is hge: mov al,HGC ;Bit 7 = 1 --> HGC 
set_mono; mov ah,MONO 7MDA and HGC set as mono screen 
jmp found it 7;Set parameters 


test_mono endp 


;-- TEST 6845: Returns set carry flag if 6845 doesn't lie in the 
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test 6845 


wait: 


t6B845 end: 


test 6845 


port address in DX 


proc near 
mov al,OAh 
out dx,al 
inc dx 

in al,dx 


mov ah,al 


mov al,4Fh 


cut dx al 


mov cx,100 


loop wait 

in al,dx 
xchg al,ah 

out dx,al 

cmp ah, 4Fh 

je t6845 end 
stc 

ret 

endp 
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;Register 10 
;Register number in CRTC address reg. 
7;DX now in CRTC data register 


7;Get contents of register 10 
zand move to AH 


7Any value 
wWrite to register 10 


7Short wait loop to which 
76845 can react 


;Read contents of register 10 
;Exchange Ah and AL 


7Send value 


;Written value been read? 
7YES --> End test 


7NO --> Set carry flag 


27Back to caller 


;-- FOUND _IT: Transfers type of video card to AL and type of = = ----- 
monitor in AH in the video vector = ===== 


’ 


found it 


set_data: 


found_it 


proc near 

mov bx,di 

cmp word ptr [bx],0 
je set _data 

add bx, 2 


mov [bx],ax 
ret 


;Address of active structure 

7Video system already onboard? 

;NO --> Data in active structure 
7;YES --> Address of inactive structure 


;Place data in structure 
;Back to caller 


7End of code segment 
7End of program 
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10.7 Accessing Video RAM from High Level Languages 


The beginning of this chapter mentioned the option of video RAM access from 
high level languages. This would allow the developer to write screen output 
routines for high level languages that would execute faster than output commands 
available to the languages, BIOS functions, or DOS functions. This option would 
be particularly attractive if it meant that we could write these routines without 
assembly language programming. 


The demonstration programs below implement direct video RAM access routines 
which display a string on the screen. Althrough there are some major differences 
between the three programs as a result of the differences between the respective 
languages (BASIC, Pascal and C), all three programs contain the same elements. 


Initialization 


Output 


Each program includes an initialization routine which determines the segment 
address of the video RAM. The routine has a variable which contains the address of 
the CRTC address register. There is a direct relationship between the video RAM 
and this address register: just as this register is always at port address 3B4H, the 
video RAM on a monochrome card is always found at segment address BOOOH. 
This combination also applies to color cards, where the address register is at port 
address 3D4H and the video RAM is at segment address B8O0H. If we know the 
port address of the CRTC address register, we can determine the segment address of 
the video RAM. Once we have determined this address, we can place it in a global 
variable and execute the initialization routine. 


All three programs have an output routine which uses the segment address we 
determined above. Each time the routine displays something, it determines the 
starting address of the video page currently displayed on the screen. This ensures 
that the output appears on the visible screen, and not on an undisplayed video 
page. We can find this from the CRT_START BIOS variable. This variable is 
located at address 0040:004E, and specifies the offset address of the displayed video 
page relative to the video page found at offset address OOOOH. 


After this address is determined, we can access the video RAM. The method used in 
the program depends on the given programming language. Let's look at each 
program in more detail. 


The C implementation 
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From a programming point of view, this is the cleanest of the three 
implementations because the video RAM can be treated as a normal variable in C. 
We first define the structure VELB, which describes the ASCII/attribute pair as it 
appears in the video RAM. We create a new data type, VP, to act as a pointer to 
this structure. It is important that this pointer be of type FAR because these 
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Structures are in the video RAM and therefore outside the C data segment. Smaller 
memory models in C require the declaration of this pointer as a FAR pointer. 


The global variable VPTR is initialized to be a pointer to the first ASCII/attribute 
pair in page 0 of the video RAM. This occurs in the INIT_DPRINT routine. It is 
used within the DPRINT function (the function used for display) as the basis for 
addressing the characters within the video RAM. 


The DPRINT function loads the LPTR pointer with the address of the screen 
Output position passed to the routine. LPTR is first loaded with the contents of the 
global variable VPTR, and then with the offset address of the active video page, as 
found in the CRT_START BIOS variable. LPTR must be cast as a BYTE pointer 
because the contents of the BIOS variable refers to bytes, and not to VELB 
Structures. If the cast operator were missing, the C compiler would generate code 
which would first multiply the contents of the BIOS variable by the length of the 
VELB structure before adding it, resulting in the wrong value. 


We can now add the display position to this pointer. The output position is passed 
to DPRINT as row and column coordinates. The video RAM is treated as an array 
of 2000 components, each of which is a VELB structure. Since we have computed 
the base address of the array in LPTR, all we need is to index into it. We multiply 
the row coordinate by 80 (columns per line) and then add the column coordinate. 
Finally we have a pointer to the output position in video RAM, which we can 
treat like any other C pointer. 


Each time through, the loop increments the pointer to the next VELB structure. 
We write the ASCII code of the character and the color passed to DPRINT to the 
specified address. This repeats until the program reaches the end of the string. 


C listing: DVIC.C 


[BRI IK RRR IIR IKI IK IIIT RK RIK IIT IIIT IRI KI IT TIAA AKITA TTA K TKK KKK / 


/* DVIC */ 
Da a ae ke oN ae RRO aA Da ie area ee a eee */ 
/* Task : Demonstrates direct access to video RAM. x / 
/* Se ai oss pk sk ms ase pus es ad i esl ce sie oa hv, dod vo sca dca asi ac nas co ca en ag Sac ack ec nar aa cha Space sed bse el Ss wus ns ce wi a nes nis aed “ec cae x/ 
/* Author : MICHAEL TISCHER x / 
/* Developed on : 10/01/1988 */ 
/* Last update : 06/21/1989 «f/f 
[ Bw rr en enn ne en ng nn nn */ 
/* (MICROSOFT C} */ 
/* Creation : CL /AS DVIC.C */ 
/* Call : DVIC «/ 
/* cs ae cen ent es cs as es comes ees eb seb Ges cee ews Sis See ese es es macs ls es cases es wid es masa es me mm Se mesa es Ges Sd i en ee mee ee ed Ce ee a/ 
/* (BORLAND TURBO C) */ 
7% Creation : RUN menu command (no project file needed) ae 


[RK KKK KER KIKI KKK IIHR KEK RK KIARA KKK KKKKEK KKK K ER HE KERR KRIEKKEII KKK / 


#include <dos.h> 
#include <stdlib.h> 
#include <string.h> 
#include <stdarg.h> 
#include <bios.h> 
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/*t== Type Gefinitions SR SESS SSS SSS SSS ESET / 


typedef unsigned char BYTE; 
typedef struct velb far * VP; 


typedef 


BYTE BOOL; 


/t== Structures sere 


struct velb { 


}; 


/* Create a byte */ 
/* VP = FAR pointer in video RAM */ 
/* similar to BOOLEAN in Pascal */ 


SiS Vas ES 


mronanssscssas ht / 


/* Describes a 2-byte position on the screen */ 
BYTE character, 
attribute; 


/* ASCII code */ 


/* Character attribute */ 


[{/t== Macros SoS a SS SS SESE / 


/*-- MK FP creates a FAR pointer to an object from a segment 
/*-- address and offset address 


#ifndef 


#fendif 


MK _FP 


#define COLOR(VG, HG) 


/*== Constants ====== 


/* MK FP not defined yet? */ 
#define MK_FP({seg, ofs) (({void far *}) ((unsigned long) (seg) <<16| (ofs))) 


((VG << 3) + HG) 


#define TRUE 1 /* Constants for use with BOOL */ 
#define FALSE 0 
/*-- The following constants return pointers to variables from the ---*/ 


/*-- BIOS variable segment at segment address 0x40 


—-—* / 


#define CRT_START ((unsigned far *) MK FP(0x40, Ox4E)) 

#define ADDR_6845 ((unsigned far *) MK FP(0x40, 0x63)) 

#define NORMAL 0x07 /* Character attribute definition */ 
#define BRIGHT Ox0f /* Based on monochrome video card*/ 
#define INVERSE 0x70 

#define UNDERSCORED 0x01 

#define BLINKING 0x80 

#define BLACK 0x00 /* Color attributes for color card */ 
#define BLUE 0x01 

#define GREEN 0x02 

#define COBALTBLUE 0x03 

#define RED 0x04 

#define VIOLET 0x05 

#define BROWN 0x06 

#define LIGHTGRAY 0x07 

#define DARKGRAY 0x01 

#define LIGHTBLUE 0x09 

#define LIGHTGREEN Ox0A 

#define LIGHTCOBALT 0x0B 

#define LIGHTRED 0x0C 

#define LIGHTVIOLET 0x0D 

#define YELLOW Ox0E 

#define WHITE Ox0F 

/*== Global variables =====s==s=s==s=s=s=ss=ssess=s=s=scssss=sssesss==ssen=t / 
VP vptr; /* Pointer to first character in video RAM */ 


[RRREIKKEKEK IKKE IKE IKKE REI KKKKEEEE KERR AERKEKEREKEKEKREAKEKEKIKKKKKK IK 


* Function >DPRINT - 
Ie as as ih is esi sa en ac a cas ak a Se een ae can ie a i Ss ces a as esd des cos ee ee ee en Se es ee xk 
* Task : Writes a string directly to video RAM y 
* t 
* Input parameters : - COLUMN = Output column * 
* - LINES = Output row * 
x - COLOR = Character attribute * 


Abacus 10.7 Accessing Video RAM from High Level Languages 


* - STRING = Pointer to string x 


* Return value : None * 
HH KI RI KI IR HRIKRIEKRERRII KR IIIKE KH KKKARKE KK I KEK E KEKE R KK KEAKIAEE ER EKREKKEEKE / 


void dprint (BYTE column, BYTE lines, BYTE color, char * string) 


{ 


register VP lptr; /* Floating pointer in video RAM */ 
register BYTE i; /* Points to number of characters */ 
/*-- Set pointer to output position in video RAM -------------------— */ 
lptr = (VP) ((BYTE far *) vptr + *CRT_ START) + lines * 80 + column; 
for (i=0 ; *string ; ++lptr, ++i) /* Execute string */ 
{ 
lptr->character = *(stringt++) ?; /* Character in video RAM */ 
lptr->attribute = color; /* Set character attribute */ 


} 
} 


[RRR KIKI IAEK KKK K KKK KERIKERI IKE IK IKKE AKKEKEEKKKKAKKKK 


* Function > INIT DPRINT . 
De Ie cca: s cms, te es cue sei iv i tn ca a ta tans i cos swims eee wn in en ea ini eins bn cei mins cmv Sn sf Ss el i So ic “ih einem Gem Sm uh ein ies Wo Su ep cpa Sn is kk 
* Task : Determines video RAM segment address for DPRINT * 
* Input parameters : None . 
* Return value : None * 
* Info : Allocates segment address of video RAM in VPTR * 
x * 


global variable 


RHEE KEKE EK AKER KEKE KKK IKE KEKE EKER KEKE KEKE KEIR ERE KEKKKKEKKEEKEKKEEK / 


void init _dprint () 


{ 
vptr = (VP) MK FP( (*ADDR_6845 == 0x3B4) ? OxBOOO : OxB800, 0 ); 
} 


[RRR IR EK II IKI KIRKE III KIKI KE KKK EKA KEKE KEKE AKEKKEKKK KK KKK KICK 


* Function : Cus x 
FOI cass cae cas cots ek es cans ius ‘ts eee ses es es en ee ce cos ce es Sos ces es ec ces Sas cw ows ees eee ce fos ie es ene ew ks Sn i em sn ne ee Se oa aan kk 
* Task : Clears the screen with the help of DPRINT * 
* * 
* Input parameters : - COLOR = Character attribute = 
* Return value : None % 


KHEKKKKEKKKEKKREKRKE KEKE KEKE KEK KKK KKK EKER KKK KKK KK KEKIEKKEKKKKKEEKKKKKKKKEKKKKE / 
void cls( BYTE color ) 


{ 
static char blankline[81] = 


{ 4 a ‘ e ‘ a e 4 t 4 e t t t ‘ ] et 8 ' t 4 @ e LY 4 ' LY ¢ 4 ‘ 
s a tf s a 


tf tf t e t ec o a v tf tA s v 8 a 
‘ i] ‘ e a ‘ 4 ty 4 ‘ t ‘ t t a 4 4 ¢ t 4 t e e t  ] 8 | ] a 8 
a v tf g v e tf LA ’ tf s e a A tf 
§ 8 4 i] ] ‘ ¢ e a a a a t e a a a e et 4 a e t e e a i] e 8 St] 
o 4 o e o tA f i a tf c td v g e 
t e ¢ t t a ‘ t t e e | t t 8 t e i] t 4 i] e 4 i] & i] ‘ e i] $ 
a a t e e g e 0 t a tA o 7 tA a 
a ‘7. " Sg eo Se NG! 
}; 
register BYTE i; /* Toop counter */ 
for (i=0; 1<24; ++1) /* Execute each line */ 
dprint (0, i, color, blankline); /* Display blank line */ 


} 


[RRA EKER EERE KKK KEKE KKK KKK KKK EKER EKKKEKKKEKEKREREKKEKRKEKKKKKKKEKKK 


* Function >NOKEY ss 
GI a a a i as Se eh a eek ee es ee cs os ee Se ee ee a eee ee ee a ak 
* Task : Tests for a keypress x 
* Input parameters : None * 
* Return value : TRUE if a key is pressed, otherwise FALSE . 


HHRAKKKRREKRE KEKE KEKE KEKE KEKE KHEKKEEKEAEKEKIEKREKKEEKEK AREER KEKKEREKEKRKKAKKKKK / 
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BOOL nokey {) 

{ 

#ifdef | TURBOC __ /* Compiling this with TURBO C? */ 
return( bioskey( 1) == 0 ); /* YES, read keyboard from BIOS */ 
felse /* Using Microsoft C */ 


return( bios keybrd( KEYBRD READY ) == 0 ); 
#endif 
} 


/* Read from BIOS */ 


[RRKKKKKEREREKRKEEE KK EERE KEKE KEK EKREEKKEKER EKER KEE EEKKEKEEREKEREKEEKREKRKEKEKK / 


[=e MAIN PROGRAM 


ak / 


[RRREKEKEKERE KKK EKER KEE KERR ERE KEKE KKK EEE EERE REE KKEEREKEEEKEE KEE / 


void main() 
{ 


BYTE firstcol, /* Color of first square on the screen */ 
color, /* Color of current square */ 
column, /* Current output position */ 
lines; 

init dprint (); /* Determine segment address of video RAM */: 


cls{ COLOR (BLACK, GREEN) ); 


/* Clear screen */ 


dprint (22, 0, WHITE, "DVIC - (c) 1988 by Michael Tischer"); 


firstcol = BLACK ; /* Start with black */ 
while( nokey() ) /* Repeat until the user presses a key */ 
{ 
if (++firstcol > WHITE) /* Reached last color? */ 
firstcol = BLUE; /* YES, continue with blue */ 
color = firstcol; /* Set first color on the screen */ 


/*-- Fill screen with squares ---------~------------ 


for ( column=0; column < 80; column += 4) 
for (lines=1; lines < 24; lines += 2) 
{ 


dprint ( column, lines, color, “MMMMM");/* Block characters can */ 
dprint ( column, lines+1, color, “MMMMMI");/* be created by press- */ 
color = ++color & 15; /* ing <Alt><2><1><9> = */ 


} 
} 
} 


The Pascal implementation 


By using the keyword ABSOLUTE or by linking in a small assembly language 
routine it would also be possible to treat the video RAM as a normal variable in 


Turbo Pascal. But there's an easier way. 


Turbo Pascal offers the arrays MEMW and MEM for accessing memory which is 
outside of the data segment of the Turbo Pascal program. The array MEM consists 
of bytes and the array MEMW of words. The two arrays don't actually exist and are 
just mapped to the address space, but that doesn't affect their usefulness. 


We can write values into the array as well as read from it. This is done with the 


following statement: 


MEMW[ segment address : offset address ] := expression 


variable := MEMW[ segment address 
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Pascal 


The MEM array might be easier to use for this particular application since we will 
be alternating between ASCII characters and a constant attribute. However, the 
output procedure DPrint uses the MEMW array instead, because 16-bit accesses are 
performed faster than two successive 8-bit accesses on 16-bit machines. 


When accessing the MEMW array, DPrint takes the segment address of the video 
RAM from the variable VSeg, which is initialized at the start of the program in 
the procedure InitDPrint. As described before, this is done by examining the BIOS 
variable which contains the port address of the CRTC address register. This and the 
other BIOS variables are declared using the ABSOLUTE keyword, allowing them 
to be used in the program like any other global variables. 


The offset within the MEMW array is computed from the starting address of the 
screen page. The coordinates are passed to DPrint, in which the row coordinate is 
multiplied by 160 and the column coordinate by two. When running through the 
string to be printed, the memory offset is incremented by two on each pass, 
moving it one ASCII/attribute pair to the right. 


listing: DVIP.P 


{BERRA RIK HER HEH K KERRIER EK KK KEIR RRR K ERK KK ERK KKK KK KER K RK EKEKKKRERKKKEKEEKER | 


{* DVIP =) 
{* ican iin Gs co sm Ss Sos i emi Sts i is i is ni cm ime et’ ics hs‘ iis a ems mi nei nits wa cc mi mis Sum‘ cai cu scum ences os Cs i ut cn ns ta ss aes ns iiss in *} 
{* Task : Demonstrates direct access to video RAM from *} 
{* Turbo Pascal mI 
{* ec ec es msc sen cies aes sn cms ces ies is sui in ime Sin cso am tu tm min ue Sia eno ai nas cs can me sm wnt’ ce chan css cs c's ems ia sit imi meen nin tua nm ‘amin use enc cs cats wi *} 
{* Author : MICHAEL TISCHER *} 
{* Developed on : 10/02/1987 *} 
{* Last update : 06/20/1989 *} 


{RRR IK RRR RRR IR KEIR RK KKK KKK ERK RIKER KEK ERK KEKE KEK KEKREKEKKKK | 


program DVIP; 


Uses Crt, Dos; { Use CRT and DOS units } 
const NORMAL = $07; { Define character attributes in } 
LIGHT = $O0f; { conjunction with monochrome } 
INVERSE = $70; { video card } 
UNDERSCORED = $01; 
BLINKING = $80; 
BLACK = $00; { Color attributes for color card } 
BLUE = $01; 
GREEN = $02; 
COBALTBLUE = $03; 
RED = $04; 
VIOLET = $05; 
BROWN = $06; 
LIGHTGRAY = $07; 
DARKGRAY = $01; 
LIGHTBLUE = $09; 
LIGHTGREEN = SOA; 
LIGHTCOBALT = SOB; 
LIGHTRED = SOC; 
LIGHTVIOLET = SOD; 
YELLOW = SOE; 
WHITE = SOF; 


type TextTyp = string[80]; 


var VSeg : word; { Segment address of video RAM } 
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{RRR RRA HH RRR RHR IRIE EERE KIER EERE REERERE IEEE REREREEREKREEEEE } 


{* InitDPrint: Determines segment address of video RAM for DPrint *} 
{* Input  : none \ *} 
{* Output : none 8 


[RE RERREREAK ARERR ERK KEKE K KEK ERKEREKKRKEEKEKEEKEKEREKEKKEKEKEKRKEKEKEKKEKKKEEKKEE | 


procedure InitDPrint; 


var CRTC_PORT : word absolute $0040:0063; { Variable in BIOS var.seg. } 


begin 
if CRTC_PORT = $3B4 then { Monochrome card connected? } 
VSeg := $B000 { YES, video RAM at BO000:0000 } 
else { NO, must be a color card } 
vSeg := $B800; { Video RAM at B800:0000 } 
end; 


[BRR RKRHKKHEK KEKE KEKE KKK KEKE EKER KE KEKKKERKEKKEREKKEKERERERKEKKEKKEREKKEKEKKEE } 


{* DPrint: Writes a string direct into video RAM *} 
{* Input : - COLUMN: Output column +) 
{* - LINES : Output line *} 
{* - COLOR : Color (attribute) for individual characters *} 
{* - STROUT: String to be displayed *] 
{* Output : none *} 


{RARER RE KKHKKRERRERKEKRKK KKK REE KKK EK KERR EEREKEKKKKEKEKEKEKEKEKKKEEKE | 


procedure DPrint( Column, Lines, Color : byte; StrOut : TextTyp); 


var PAGE OFS : word absolute $0040:$004E; { Variable in BIOS var.seg. } 
Offset : word; { Pointer to current output position } 
Vey : byte; { Loop counter } 
Attribute : word; { Attribute for output } 
begin 


Offset := Lines * 160 + Column * 2 + PAGE OFS; 
Attribute := Color shl 8; { High byte for word access to video RAM 


} 

1 s= length( StrOut }; { Determine string length } 
for j:=1 to i do { Execute string } 
begin { Put character & attribute directly into video RAM } 


memw [VSeg:Offset] := Attribute or ord( StrOut[j] ); 
Offset := Offset + 2; { Set offset to next ASCII/attribute pair } 
end; 
end; 


{BEARER RRR HEK EK EER K RHE R EKER ERK KEK KEKE RERERRRKE ERR EREKERERKREKEKKKE | 


{* Demo: Demonstrates application of DPrint *} 
{* Input : none +} 
{* Output : none ~) 


{ RERRAKK HHA RH EK EKEEE KEKE EKER ERKEKEKRKEKEK EKER EKKEKEKKKEKEKKEKE | 


procedure demo; 


var Column, { Current output position } 
Lines, 
Color : integer; 


begin 
Text BackGround( BLACK ); { Turn background black } 
Cirscr? { Clear screen } 
DPrint ( 22, 0, WHITE, 'DVIP - (c) 1988 .y Michael Tischer'); 
Randomize; { Enable random number generator } 
while not KeyPressed do { Repeat until user presses a key } 
begin 
Column := Random( 76 ); { Select column, row and } 


Lines := Random( 22 ) +1 
Color := Random( 14) +1 


. { color at random } 
DPrint( Column, Lines, Color, ‘[{{{{')2{ Block character can be } 


\ 
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DPrint ( Column, Linest+1, Color, '[([[{['};{ created by pressing } 

end; {<Alt><2><1><9> } 

ClrScr; { Clear screen } 
end; 


{ MERAH RAKE K EKER RAKKKKEKKEKR EKER KEKKERKEKRAKEKKKRKEKRKEAKKERKKKKKEKEE } 


{** MAIN PROGRAM baa | 
[RII ICICI ICICI OIRO III IR TOR IT HAIR) 


begin 
InitDPrint; { Initialize output using DPrint } 
Demo; { Demonstrate DPrint } 
end. 


The BASIC implementation 


This version doesn't really fulfill its goal, since it is slower than the already slow 
PRINT command. But we have included it for the sake of completeness, and 
because it is a good example of how you can access the entire address space of the 
8088 from within BASIC. 


The commands DEF SEG, PEEK, and POKE are the heart of memory access in 
BASIC. DEF SEG sets the segment address of the "current" 64K segment. PEEK 
and POKE can then be used to read and write bytes from or to this segment. This 
technique is used in the initialization routine at line number 50000, which first 
defines the BIOS variable segment as the current segment. From there two PEEK 
commands read the port address of the CRTC address register and the variable VR 
is loaded with the segment address of the video RAM. 


This address is used in the output routine at line number 51000 in combination 
with the DEF SEG command, which defines the video RAM as the current 
segment. But first we calculate the offset address in the video RAM by reading the 
Start address of the current screen page from the BIOS variable area and then adding 
the offset address of the output position within the video RAM. As in the Pascal 
version, this is calculated by adding the product of the row coordinate (variable 
CLINE%) by 160 and the column coordinate (COLUMN®%) by 2. 


BASIC listing: DVIB.B 


100 UCHKKKKKKKKEKKKKK KKK KEKE KAKA KKK KEKKEEKKKKES 


110 ‘* DVIB ake 
120 0S ass Sas cla ses ts ess ss cs ts nc oe ets ce sm as ics cas Sa mas eons sin Ti ne Se cots ss las ag nis ol Ss cs Sas tsp dns Sn masa us eb es Cus Sash wu fa aus cutee as oe eh tne esta nS re 
130 '* Task : Demonstrates direct access to video RAM x 
150 '* Author : MICHAEL TISCHER “= 
160 '* Developed on : 10/01/1988 = 
170 '* Last update : 06/21/1989 bee 
180 PKK KKKKKEKKKKKKEK KEKE KKKKKKK KKK KKEKKEKEKKKKKKKEKEKKEKEKEKKEKKEKKKKEKEKEKEK 
190 ! 

200 CLS : KEY OFF 

210 GOSUB 50000 ‘Determine segment address of video RAM 


220 COLUMN%=22 : CLINE%=0 : COL% = 15 
230 T$ = "DIVB — (c) 1988 by MICHAEL TISCHER" : GOSUB 51000 


240 FCOLS = 0 : TS = "[{[[[" "Define string and starting color 
250 AS = INKEYS : IF A$<>"" THEN 400 ‘Repeat until user presses a key 
260 FCOLS = FCOLS + 1 ‘Increment starting color 
270 IF FCOL%S > 15 THEN FCOL% = 1 ‘when FCOL%=16 make FCOL%=1 
280 COL% = FCOL% ‘Set color for first square 
290 FOR COLUMN%=0 TO 76 STEP 4 ‘Execute for each column 
300 FOR 2%=1 TO 24 STEP 2 ‘Execute for each line 
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310 CLINES = Z% =: GOSUB 51000 ‘Display first line of square 
320 CLINE&S = Z%+1 =: GOSUB 51000 ‘Display second line 
330 COL% = COL% + 1 AND 15 ‘Set next color 
340 NEXT 

350 NEXT 

360 GOTO 250 

370 ' 

400 CLS ‘Clear screen 
410 END 

460 ' 

50000 CHR HK KKK KKK KKK KEKE KKK K KKK KEKKKKEKKKKEEKKKS 
50010 '* Determine segment address of video RAM 
SOO 20 8 Rm a a a a rn = 
50030 '* Input : none as 
50040 ‘* Output : VR is the segment address of video RAM = 
50050 (PSS RESSOCSCLAESE SEL ELCC LESS ESSE ECCS SSE SESE SLSR ASL ECL ESR ELE SS SESE Se So 
50060 ! 

50070 DEF SEG = &H40 ‘Segment address of BIOS variable range 
50080 VR = PEEK (&H63) + PEEK(&H64) * 256 ‘Get CRTC port 
90090 IF VR = &H3B4 THEN VR = &HBOOO ELSE VR = &HB800 

50100 RETURN ‘Back to caller 
50120 ! 

51000 CREEK EKEKEKREKKREKEKREKKKEEKKEKEKEKEKRERKEEEKEKREKEKEKKKKKEKKS 
91010 '* Write string direct into video RAM = 
51020 8 8 ee nn a nn nnn ern rn enna 7 
91030 ‘* Input : — COLUMN% = the output column mt 
51040 '* - CLINES = the output line xt 
51050 '* - COL% = string color a 
51060 '* - T$ = the string to be displayed - 
51070 ‘* Output =: none “ 
51080 ERK KIKI KKK KKK KKK KKK EERE EKKKREEKEKEKKKEKEKEKKKKKKKKKKKEKN 
51090 ! 

51100 DEF SEG = &H40 ‘Segment address of BIOS variable range 
51110 OF% = PEEK(&H4E) + PEEK(&H4F) * 256 ‘Starting address of page 
51120 OF&% = OF% + COLUMNS * 2 + CLINE% * 160 ‘Offset of first character 
51130 DEF SEG = VR ‘Set segment address of video RAM 
51140 FOR I%=1 TO LEN(TS) ‘Execute string 
51150 POKE OF%, ASC (MIDS (TS, I%,1)) ‘ASCII code in video RAM 
51160 POKE OF%+1, COL% ‘Color in video RAM 
51170 OF% = OF% + 2 ‘Set offset to next character 
51180 NEXT 

51190 RETURN ‘Back to caller 
51200 ! 
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Chapter 11 


Accessing and Programming 
the AT Realtime Clock 


The AT has a battery operated realtime clock on the main circuit board. The clock 
is part of the Motorola MC-146818 processor. This processor also contains 64 
bytes of battery backup RAM. This RAM accepts clock data and system 
configuration data. It can be accessed through port addresses 70H to 7FH. 
However, only ports 70H and 71H are of interest to the user. 


Realtime clock registers 


As the following table shows, the clock has thirteen memory registers of interest: 


JO current second 
4 current_hour 
ee 


5 
of the week 


ae 
Da 

‘7 Number of day 
Brea MOM aa 
aa, 
110_—s|Clock status register AU 
fii Clock status register Bo 
[12 | Clock status register Co 
fg eed 


7 
10 
11 
12 
13 Clock status register D 


Every time field (second, minute, hour) has a similar alarm field. These alarm 
fields allow the programmer to set the clock to trigger an interrupt at a particular 
time of the current day (more on this later). 
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Weekday 


Year 


The day of the week provides the number of the current weekday: The value 1 
represents Sunday, the value 2 stands for Monday, 3 for Tuesday, etc. 


The year is counted relative to the century (the system assumes 1900). The value 
87 in this field represents the year 1987. 


The four status registers allow user programming of the clock. 


7 6 3) 4 3 2 1 O bit 


Interrupt frequency 


Time frequency 


VIP 
=Time not actualized 
1=Time actualized 


Status register A of the clock 


The ROM-BIOS set the two lower fields of these registers during the system boot. 
The interrupt frequency field has a default value of 0110(b). This value results in 
an interrupt frequency of 1024 interrupts per second (an interrupt every 976,562 
microseconds). 


The contents of the time frequency field is 010(b). This field triggers a time 
frequency of 32,768 kiloHertz. 


Bit 7 of the status register is of interest to the programmer in conjunction with 
these two fields. It indicates whether a second has just elapsed, and increments the 
time fields (seconds, minutes, hour). If a second hasn't elapsed, this bit contains a 
1. This bit is interesting because you can only read the individual time fields when 
the time is not being updated. Otherwise a minute could pass and the second 
counter reset to 0 before the minute counter could be incremented. This could cause 
a time jump from 13:59:59 to 13:59:00, then the correct display of 14:00:01 one 
second later. 


Accessing status register A 
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Since status register A is a part of the 64-byte RAM, you can access it like any 
other memory location. First you load the number of the memory location to be 
accessed into the AL register (in this case, the value 10). Then you pass this value 
to port 70H using the OUT instruction. The chip recognizes that an access to one 
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of its memory locations occurred. Either an OUT insiruction then writes to port 
71H or an IN instruction reads the memory contents from port 71H. 


The following instructions read or write a memory location in the realtime clock: 


READ: WRITE; 

mov al,Memory location mov al,Memory location 
out 70h,al out 70h,al 

in al, 71h mov al,New_contents 


nwt TTIW = 1 
(hdd gp Aw 
Status register B 


Some clock settings can be programmed through status register B. Bit 0 of status 
register B controls daylight savings time status. When this bit is set to 1, it 
indicates that daylight savings time is in effect. A vaiue of 0 (the default value for 
this bit) shows that standard time is in effect. 


Bit 1 decides whether the clock should operate in 12-hour or 24-hour mode. In 12- 
hour mode it switches after every 12 hours (midnight and noon) to 1 o'clock again. 
The 24-hour mode switches to 1 o'clock after 24 hours. 24-hour mode is active 


when you boot the system. 
Daylight savings time | 
O=yes 7 
f=no Cr —— 
[Time and date format | 
0=BCD | 
1=binar | 


Call interrupt after 
time actualization 
O=no 
1=yes 


Call periodic interrup I 
O=no 
1=yes | } 


Clock status regisier B 


7 6 5 4 3 2 1 =O pit 


24-/12-hour format 
0=12-hour 
1=24-hour 


Block generator 
D-off 
m=on 


|Cail alarm interrupt =| 
O=no 

jizyes 

Actualize time 

| O=yes 

i1=no 
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566 


Bit 2 defines the format in which the time and date fields are stored. If this bit 
contains a 1, the various dates are stored in binary notation. The year (19)87 is 
coded as 01010111(b) in BCD format, which is switched on by the value 0 in bit 
2. Two numbers are stored in every byte. The higher half is stored in the most 
significant four bits and the lower half in the least significant four bits. 


Bit value 


2! 26 29 24 23 22 9! 99 


Binary 


0 +64+0 16+04+4+2+1= 87 


2° 2% 21 20 23 22 21 2° Bit value 
7 6 5 4 3 2 1 
scp Lt1ojojo} [oj1j1j}2. 


8+0tT0+0=8 O0+442+1 


Sees 
8*10 + 7 


(8*10) + 7 = 87 


The number 87 in binary and in BCD (Binary Coded Decimal) format 
Normally this bit contains a 0 and the numbers are stored in BCD format. 


Note; BIOS assumes BCD representation when performing the date 
function with interrupt 1AH. Application programs which call these 
functions and obtain the information in binary format instead of the 
expected BCD may crash. The same applies to the 12-hour/24-hour 
time measurement, although a change to the 12-hour cycle wouldn't 
result in as serious consequences as the change in the date. 


Bit 4 determines whether an interrupt should be called after the time (and date) 
update. This bit must contain a 1 if an interrupt should be called. The system 
suppresses this interrupt by setting this bit to 0 during the booting process. 


Bit 5 can trigger an alarm. The clock reads the alarm time from locations 1, 3 and 
5 (seconds, minutes and hours) of clock RAM. When the alarm time is reached, an 
interrupt executes when bit 5 is set to 1. The system suppresses this interrupt 
when it sets bit 5 to 0 during the booting process. 


Bit 6 controls periodic interrupt calls when it is set to 1. The frequency of the 
interrupt calls depends on the interrupt frequency coded into bits 0-3 of status 
register A. Since the default value on bootup is a frequency of 1,024 kiloHertz, the 
interrupt triggers every 967,562 microseconds. Since bit 6 is set to O at the system 
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Start, an application program must set it to 1 before periodic interrupt calls can 
execute. 


Bit 7 controls the periodic updating of the time and date, once every second. This 
bit is set to 0 when you boot the system so that the time constantly increments. 
Before entering a new date and time in the various memory locations, this bit 
should be first set to 1 to prevent the clock from changing the time immediately. 
Once you have entered all the data necessary, this bit can be reset and the time can 
continue updating. 


Calling the correct interrupt 


We've used the phrase “calling the interrupt" many times in this section, without 
really telling you which interrupt should be called. Even though there are several 
reasons for the clock to call an interrupt (alarm time, periodic interrupts, etc.), 
interrupt 70H is the interrupt consistently called. This interrupt contains a BIOS 
routine which controls the two time functions in interrupt 15H, among other 
things. 


The routine uses status register C of the clock to determine the reason for the call. 
Only bits 4, 5 and 6 of this register are of interest to us here. They correspond to 
the bits in status register B. For example, when you trigger the alarm interrupt 
(which can only occur if bit 5 in status register B was set) then bit 5 in status 
register C is also set to indicate that the alarm time has been reached. 


1=close time actualization 


Status register C 


The first task of the routine which intercepts interrupt 70H is to read status register 
C. The routine then determines the reason for the interrupt call and reacts 
accordingly. 
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Status register D 


Status register D only has one bit of interest: bit 7. It indicates the status of the 
battery which maintains the storage of data, even when the PC's power supply is 
turned off. If this bit has the value 0, you should replace the battery because the 
present battery is dead or near death. 


Some configuration information follows status register D. 


Byte 
114. Diagnostic byte —s—s—ssss—“(i‘“‘“‘(‘(‘(C;s:sSSSCS 
[15s] Status on termination of the system 
16 
18 

19 

20 
2 

22 

23 

24 
25-45 
47 ? 
50 

51 
52-63 


Hard Disk description 


BC OFE LU a Uo ee 


Low byte of the additional memory in kilobytes 


ae 

aes 

a9 

20 

Cre 

2a [High byte of the additional memory in kilobytes 
25-45 

Cae ITE 

a7 3 

aa zs 

as i 

So 
even 
52-63 


Diagnostic byte (address 14) 


568 


O = Hard disk and controller o.k. 

1 = Hard disk not present or not functional 

O = Memory size in memory locations 21-24 

1 = other memory size determined during booting 
= Configuration in memory location 20 o.k. 

1 = another configuration found during booting 

O = Checksum in memory location 46 and 47 o.k. 

1 = Checksum in memory location 46 and 47 is false 

O = Battery is o.k. 

1 = Battery dead or almost dead 
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Disk description (address 16) 
bit, =e [meaning i 


0-3 Type of second installed drive (DOS designation: B) 
| 0000(b) = no second disk drive 
ee Ns = $0001 (by 8320/360K Grive: 2 oe 
| 0010 (b) = 1.2 megabyte drive 
Cea Ese Rea ee eee eee ae 
as 
ae 


0000 (b) no disk drive 


Q001(b) = 320/360K drive 


Note: If you program the clock for generating time-dependent interrupts, 
and you point interrupt vector 70H to a user routine, remember that 
if the user routine's end doesn't return to the BIOS, you must send an 
EOI instruction to the AT's two interrupt controllers, since interrupt 
70H is a hardware interrupt triggered by one of these controllers. 


Demonstration programs 


The three programs listed below show how you can access the realtime clock from 
BASIC, Pascal or C. Three routines in particular perform most of the functions. 
The first routine reads a value from one of the clock's memory locations. The 
second routine places a value there. The third routine checks whether the clock 1s 
operating in binary mode or BCD mode, then reads a memory location in the 
Clock, converting the contents of this location from BCD into binary if necessary. 
This routine is important for access to all memory locations containing 
information on date and time which could be coded in BCD or in binary format. 


The main program checks the battery on the clock. If there's power in the battery, 
the program calls two routines which read the contents of the memory locations 
for the current date and current time from the clock, among other things. This data 
appears on the screen. 


The main program doesn't access the routine for description of memory locations. 
It should be easy to convert the program so that the routine for the description of 
memory locations writes to the clock instead of reading date and time. This is just 
a suggestion; feel free to experiment. 


BASIC listing: RTC.BAS 


100 ORK KKKKKIEK EEK KEK KKK KEK KEK KEKE KEKE KKKKEAKEKKKKKEKAKKEES 


110 *'* RTC wt 
120 I a a a a a a a as re his as a sa Sa Se de se se eas ns es ees ee ew *! 
130 '* Task : makes two Subroutines available “7 
140 ** ~ for reading and writing data oi 
£50 ** from the RTC of the AT we 
160 ** Author : MICHAEL TISCHER = 
170 '* developed on : 7.24.87 oi 
180 ‘'* last Update : 9.21.87 x 
190 CREME KEKE KKKREKKERKKEKEKREKKEKEKKEKEKKKKKKEKEKKKKEKEKKKKKKKKK! 
200 ' 

210 CLS ‘Clear Screen 


230 PRINT"RTC (c) 1987 by Michael Tischer* : PRINT 
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240 PRINT" Information from the battery buffered real time clock " 


250 P RINT e==s2222222=22==2 ors *Rimonisma oe aes ceseaese seas 


260 PRINT 

270 ADR& = 14 : GOSUB 50000 ‘read diagnostic-byte from the RTC 
280 IF (CON% AND 128) = 0 THEN 310 ‘bit 8 = 1 --> battery o.k. 

290 PRINT" WARNING! The battery of the clock is low!" 

300 END 

310 ADR& = 11 +: GOSUB 50000 ‘read status-register B of the RTC 


320 PRINT"~ the clock is operated in "; (CON% AND 2) * 6 + 12;“hour-mode “ 
330 PRINT"— the time: "; 


340 ADRS = 4 : GOSUB 52000 ‘read the hour and convert to decimal 
350 PRINT USING "##:";CON%; 

360 ADR& = 2 : GOSUB 52000 ‘read the minutes and convert to decimal 
370 PRINT USING “##:"“;CON$%> 

380 ADR& = 0 : GOSUB 52000 ‘read the seconds and convert to decimal 


390 PRINT USING "##";CONS 

400 PRINT"—- the date: "; 

410 ADR%& = 6 : GOSUB 52000 ‘read day of week and convert to decimal 
420 RESTORE 540 

430 FOR I% = 1 TO CON% : READ DAYS : NEXT ‘read name of the day 

440 PRINT DAYS;", the “; 

450 ADR& = 7 : GOSUB 52000 ‘read day of month and convert to decimal 
460 PRINT USING "##.";CON%; 

470 ADR& = 8 : GOSUB 52000 ‘read month and convert to decimal 

480 PRINT USING "##.";CONS%; 

490 ADR& = 9 : GOSUB 52000 ‘read year and convert to decimal 

500 PRINT USING “####" ;CON%+1900 

510 PRINT 

520 END 

930 ° 

940 DATA “Sunday", “Monday", "Tuesday", "Wednesday" 

550 DATA “Thursday", "Friday", “Saturday* 


560 ! 

50000 VHRR EK KEKE KKEKEEEKKKEKKEREKEKKREKEKKEKKKKKKKREEKEEKKKEKKEKKKEE I 
50010 ** read the content of a memory location of the RTC | ia 
50020 8 tana a a en nn nnn - 
90030 ** Input: ADR%& = the number of the memory location (0 to 63) *' 
50040 ** Output: CON% = the content of this storage location ws 
50050 ORK KKKKKKKEKKKKKEKKEKEKEKEKKEKEKEKREKEKEKKEEKKKEKKKKEKEEKKEKEKEKEKEKEK 
50060 ° 

50070 OUT &H70, ADR%& ‘number of memory location to RTC-address-register 
50080 CON% = INP(&H71) ‘read Content from RTC-data-register 

50090 RETURN ‘back to caller 

50100 ! 

51000 CHK KKAKKKKKKKEEKKKHAKEKKKKKKEREKKEKKEKEKKKEKEKKEEAKEKKEKEKRKKKKKKKKKKEK 
51010 '* write a memory location in the RTC dey 
91020 '*----------~-----—-------~----- --- + - - - — + ee ws 
51030 ** Input: ADR%& = the number of the memory location (0 to 63) *' 
51040 '* CON% = the new content of this memory location es 
51050 '* Output: none = 
51060 PRR K KEKE KKKKKEKK KEKE KEKE EK KKKEK KK KKK KKKEEKKKKKKKKKKKK 
51070 ' 

51080 OUT &H70,ADR% ‘number of memory location to RTC-address-register 
51090 OUT &H71,CON% ‘write new content into RTC-data-register 

51100 RETURN ‘back to the caller 

51110 ' 

52000 THK KKKKKKKKKKEKEKKKKKEKKKKEKEKEEKEKEKEKKKEEK KEKE EKKEKREKEKEKKKEKEK 
52010 '* read the content of a date or time memory location sia 
52020 '* from the RTC and convert to decimal wn 
bo 71 0 1G 1 0 ee xe 
52040 ** Input : ADR%& = the number of the memory location (0 to 63) *' 
52050 '* Output: CON% = the new content of this memory location xe 
52060 '* Info : ADR%& is changed by this subroutine = 
52070 OR KREKKKEKK KK KEKE KKK KKKKEKK EEK KKEKKEKKEKKEEKKKEKKKKKEKKKEKEKES 
52080 ' 

52090 GOSUB 50000 ‘read content of the memory location 
52100 BCD% = CON% ‘record content of the memory location 
92110 ADR%& = 11 ‘Address of the Status registers B of the RTC 
52120 GOSUB 50000 ‘read its content 

52130 IF (CON% AND 2) = 0 THEN 52150 ‘test if BCD-mode 
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52140 BCD% = (BCD% AND 15) + INT(BCD% / 16) * 10 ‘convert BCD to decimal 
52150 CON% = BCD% ‘set return value 
52160 RETURN ‘back to caller 


Pascal listing: RTC.PAS 


{ RRA RHR KARR K IK KEK EK EEK K KKK KKK EKER KKK KEKEKEKKKEKRKEKEKKKKKKEKEKK KK } 


{* RT <¢ *} 
{* at sn chad ens mms ct ir us ms mews cess cues sss eas bats ice tc co Si ws stm ste is cds ccs SCs es cs ee esc eum mm en “a cs im Se ea en ised om *} 
{* Task : makes two Functions available for reading and *} 
{* writing data in the RTC *} 
{ *¥----~---+ ~~~ +--+ - +--+ + +--+ *} 
{* Author : MICHAEL TISCHER *} 
{* developed on : 7.10.87 *} 
{* last Update : 9.21.87 a 


{ BERR RRR KERR RK RRR EK ERK KERR EK RK KKK KK KEK KEKE KKEKEKEKKKE KEE KEREKKEKKEKKEKEK KE } 


program RTCP; 


Uses {Turbo 4.0 only} 
Crt; 


const RTCAdrPort = $70; { Address-Register of the RTC } 
RTCDtaPort = $71; { Data-Register of the RTC } 


SECONDS = O; { Addresses of some memory locations of RTC } 
MINUTE = 2; 
HOUR = 4; 
DAYOFWEEK = 6; 
DAY = 7 
MONTH = 8; 
YEAR = 9; 
STATUSA = 10; 
STATUSB = 11; 
STATUSC = 12; 
STATUSD = 13; 
DIAGNOSIS = 14; 
YEARHUNDRED = 50; 


{ REAR ERR KEKE KEKE ERKEKEKREKKKREKKEKEREKEKAKKEKREEKEKKK KK KK KKK KKK KK KK | 


{* RTCREAD: reads the content of a memory location of the RTC *} 
{* Input : the address of the memory location in the RTC *} 
{* Output : the content of this memory location af 
{* Info : if the Address is outside the permitted area *} 
{* (0 to 63), the value -1 is returned x} 


{ BERRA KEKE KEIR RIKER IKI RK KKK REE ERIK KIKI HIKE IK IKI K IAEA KEKKE KEK KK 


function RTCRead (Address : integer) : integer; 


begin 
if (Address < 0) or (Address > 63) { is the Address o.k.? } 
then RTCRead := -1 { NO! } 
else 
begin 
port [RTCAdrPort] := Address; { transmit Address to the RTC } 
RTCRead := port [RTCDtaPort ] { read its Content } 
end 
end; 


{EAH KK AREA RRA KKK KKK KER EK KK KEKE HERE KKIK IKKE KEKE KERR KE REKEKKKK KK | 


{* RTCDT : read a memory location for date or time from the *} 
{* RTC and convert the result into a binary value *} 
{* if the RTC works in BCD-Format a 
{* Input : the address of the memory location in the RTC *} 
{* Output : the content of this memory location as binary value *} 
{* Info : if the address is outside the permitted area (0 - 63) *} 
{* the value -1 is returned i 
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{ RRR KK KEKE EK KKK KEK KEK ERE K KKK KEK KEKE KKK KKK KK HK KKK KEKE RKKRKEKEKEKKEKKEE | 


function RTCDT (Address : integer) : integer; 


var Value : integer; { for memory of a value which was read } 
begin 
if (RTCRead(STATUSB) and 2 = 0} { BCD- or Binary-Mode? } 
then RTCDT := RYCRead (Address) , { is Binary-Mode } 
else { is BCD-Mode } 
begin 


Value := RTCRead (Address); { get Content of the memory location } 
RTCDT := (Value shr 4) * 10 + Value and 15{ convert BCD to binary } 
end 
end; 


{ FR RRH KKK REE KKK RE KE KKK KEK KKK KKK KHER KE KKK KKK KEKEKEKEKRKEEKKKKKKKKKKKKEKKK KE | 
{* RTCWRITE: write a value into one of the memory locations of RTC *} 


{* Input 2 see below 
{* Output =: none =} 
{* Info : the address can be between 0 to 63 =} 


{ FREER KKK KEKE KKK KEKE KEK ERK KKEKEEKEKKKEKKKKKKREKEKEKKKEKEKKKKEKKEKKKKKKEEKK | 


procedure RTCWrite (Address : integer; { the address of the location } 


Content : byte); { the new content } 
begin 
port [(RTCAdrPort] := Address; { transmit address to the RTC } 
port [(RTCDtaPort] := Content { write new value } 
end; . 


{RRR HARKER KERRI R KKK KKK KKK RRR KAR KR IKKE RK KKK KKK RAKE EKKEKHEKK KK | 


{* MAIN PROGRAM *) 


{ BRAK RAKE KHE KEKE RK KKK KKK KKK KEK KKK KKK KEK KKK KKK EKER AKER EKER ERK KKKKK EK | 


begin 

clrscr; { Clear Screen } 
writeln('RTC (c) 1987 by Michael Tischer'#13#10); 

writeln('Information from the real time clock '); 


writeln (! ===ss=ssss2ssHsssssssssssssssssssesssessssSsssss=e==='! $1310); 
if RTCRead(Diagnosis) and 128 = 0 then { is the Battery o.k.? } 
begin { the Battery is o.k. } 


writeln('-the clock is being operated in ', (RTCRead(STATUSB) and 2)*6+12, 
* hour-mode') ; 
writeln('- the time: ‘, RTCDT(HOUR), ':', RICDT (MINUTE) :2, 
‘:', RTICDT (SECONDS) :2); 
write('- the date: '); 
case RTCDT (DAYOFWEEK) of { Read Day of the Week } 
: write('Sunday'); 
write('Monday'); 
write(‘Tuesday'); 
write ('Wednesday'); 
write('Thursday'); 
write('Friday'); 
write ('Saturday') 


SNOW PWD 
ee e0 se ce se es @ 


end; 
writeln(', the ‘,RTCDT (DAY), '.', RTCDT (MONTH), '.', 
RTCDT (YEARHUNDRED), RTICDT (YEAR) ) ; 


end 

else { the Battery of the RTC is exhausted! } 
write(' WARNING! The Battery of the clock is low!'‘) 

end. 
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C listing: RTC.C 


[RAITT IIR KIT IRI IK IKK RRR IKI ITT ITT IT IK ITI KIKI IIT IKK ARK RAK IK / 


/* RTC */ 
/* os is aS saa ace Ses a eas ees ns we eat a cn es aks es es ea cs wets as dW Be Re Ree eee eee ee ewe a/ 
{* Task : provides two Functions for reading and writing */ 
/* Data in the Real Time clock */ 
/* “is a esse ess Sass eis es Sas cee cis tects ms Gen ses es ems es “acs es cas ses cee ase ens mes sacs meen ads Sg cen ces cc ced ses sl ee es tes “mia cos es cos esas nae ei ns ces Gems ms es a] 
/* Author : MICHAEL TISCHER */ 
/* developed on : 8.15.87 */ 
/* last Update : 9.21.87 x7. 
| ee a a a a Ee a ae ee */ 
/* (MICROSOFT C) a J 
Y is! Creation : MSC RTCC; */ 
/* LINK RTCC; */ 
/* Call : RTCC */ 
/* cit amw cine cme as sms meds incl musa semis ‘eh mun edu da’ nm nis mmm cmc nc ps min ean cin Si Gems cm uh Tuy G'S us ine Gau ui ua dm as cos oa, now x/ 
/* (BORLAND TURBO C} */ 
Lm Creation : Through the RUN command in the command line x] 


[RRA IKIKI KEI KIKI KKK AK KIKI IK KKK KEKE KIKI KIHK KEKE KRHA KKE KK / 


#include <dos.h> /* Include header-files */ 


#include <conio.h> 
#define byte unsigned char 


#define RTCAdrPort 0x70 
#define RTCDtaPort 0x71 


/* address-register of the RTC */ 
/* data-register of the RTC */ 


#define SECONDS 0 /* addresses of some memory locations of RTC */ 
#define MINUTE 2 
#define HOUR 4 
#define DAYOFWEEK 6 
#define DAY 7 
#define MONTH 8 
#define YEAR 9 
#define STATUSA 10 
#define STATUSB 11 
#define STATUSC 12 
#define STATUSD 13 


#define DIAGNOSE 14 
#define YEARHUNDRED 50 


[RRR KIKI KKK IKK KIKI KEK KKK KKK KKK KEK KK KKK KK KKK KKK KEKE KKK EKKEKKKKKKE / 


/* RTCREAD: reads the content of a memory location of the RTC */ 
/* Input : the address of the memory location in the RTC */ 
/* Output : the Content of this memory location */ 


[J RRR IHR KIKI KKK KKK KKK KKK KKK KKK IKK AK KKK EK KAKA KAKA AEKEAEKEKAKK EK / 


byte RTCRead (Address) 
byte Address; /* the memory location of the RTC */ 
{ 

outp(RTCAdrPort, Address); 
return (inp(RTCDtaPort)); 

} 


/* transmit address to the RTC */ 
/* read content and transmit to caller */ 


[KIKI KI KKK IKK IKI KI KIKI KK IKK KKK RIKKI KK KK KIRK KIKI KKEK EEE KKK KKK / 


/* RTCDT : reads date or time from one of the memory locations */ 
/* and converts the result into a Binary value a 
i if the clock works in BCD-Format af. 
/* Input : the address of the memory location in the RTC */ 
/* Output : the content of this memory location as Binary Value i 
/* Info sif the address is outside the permitted area a7 
/* (0 to 63) the Value -1 is returned a} 


[RRR KKK RIKKI KKK KKK IKK III KIRKE KKK KKK AKAIKE AKER KAKEK KKK EK / 


byte RTCDt (Address) 


byte Address; /* the memory location in the RTC */ 
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{ 


if (RTCRead(STATUSB) & 2) /* BCD- or binary mode? */ 
return ( (RTCRead (Address) >> 4) * 10 + (RTCRead (Address) & 15)); 
else return (RTCRead (Address) ); /* is binary mode */ 


} 


[RRR IKKE KKK KKK KEK KAKI KKK KEKE KKK KEE KKK ERE KEIR EKER EEKKEKKK EK / 
/* RTCWRITE: write a value into one of the memory locations of RTC */ 


/* Input : see below */ 
/* Output : none */ 
/* Info : the address must be between 0 to 63 x/ 


[RRR EEK KEK AK KIKI KICK KKK IKEA AKIRA AK KAR AEREKKEKKEKKEKKKKAKKKKK / 


void RTCWrite (Address, Content) 


byte Address; /* address of the memory location */ 
{ 
outp(RTCAdrPort, Address); /* transmit address to the RTC */ 
outp(RTCDtaPort, Content); /* write new value */ 


} 


[RRR KEE KEK ERE K KEK KKK KEKE ERK KEK KKK AKAIKE KEKE KEEKEKEEKEE / 


ire. MAIN PROGRAM bal 


[RRR KKK KERR KK KERR KKK KEKE KK KEK IKK KIRKE KKK EKER EKER KEKE KEKKKEKEKKER / 


void main() 


{ 
Static char *Weekdays[] = /* Names of the weekdays */ 


{ 
“Sunday", “Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" 


}e 


printf("\nRTC (c) 1987 by Michael Tischer\n\n"); 
printf ("Information from the real time clock\n"); 


if (! (RTCRead(DIAGNOSE) & 128)) /* is the Battery o.k.? * 
{ /* the Battery is o.k. */ 


printf("- The clock is operated in %d hour mode \n", 
(RTCRead (STATUSB) & 2)*6+12); 
printf ("- the time: %2d:%2d:%2d\n", 
RTCDt (HOUR), RTCDt (MINUTE), RTCDt (SECONDS) ); 
printf("- the date: ")}?; 
printf("%ts, der td.%d.%d%d\n", Weekdays (RTCDt (DAYOFWEEK)-1], 
RTCDt (DAY), RITCDt (MONTH), RTCDt (YEARHUNDRED), RTCDt (YEAR)); 


} 


else printf (" WARNING! The battery of the clock is low!\n"); 
} 


574 


Chapter 12 


Keyboard Programming 


The keyboard is an independent unit in the PC system, and has its own 
microprocessor and memory. The processor informs the system when a key is 
pressed or released. It does this by sending the system something called a scan code 
when a key is pressed or released. In both cases the key is indicated by a code 
which depends on the position of the key. These scan codes have nothing to do 
with the ASCII or extended keyboard codes to which the system later converts the 
keypresses. 


Communication with the system is performed over two bidirectional lines using a 
synchronous serial communications protocol. In addition to the actual data line 
used to transfer the individual bits, the clock line synchronizes the periodic 
transmission of signals. Transfers are made in one-byte increments, whereby a stop 
bit 1s transmitted first (with the value 0), followed by the eight data bits, 
beginning with the least significant bit. A parity bit, calculated using odd parity, 
follows the eighth data bit. The transfer of a byte then concludes with a stop bit, 
which forms the eleventh bit of the transfer. At both ends of the communications 
line (i.e., in the PC and in the keyboard itself) are devices which convert the 
signals on the data line to bytes and back again. 


Although all types of PCs use this form of communication, we must distinguish 
between PC/XT and AT models. These systems use different processors as 
keyboard controllers. The Intel 8048 used in the keyboards of PCs and XTs is a 
relatively "dumb" device, which can only send the scan codes to the system. 
However, the 8042 processor used in AT and 80386 keyboards can do much more. 
Here the communication between the system and the keyboard becomes relatively 
complex, and the system can even control parts of the keyboard. 


The heart of this communication at the keyboard end is represented by a status 
register and input and output buffers. The buffers transfer: 


° Keyboard codes which correspond to pressing or releasing a key 


° Data which the system requests from the keyboard 
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These buffers can be accessed at port 60H on the AT. 


The input buffer can be written at port 60H as well as port 64H. The port which is 
used depends on the type of information to be transferred. If the system wants to 
send a command code to the keyboard, it must be sent to port 60H, while the 
corresponding data byte is sent to port 64H. Both end up in the keyboard input 
buffer, but a flag in the status register indicates whether a command byte (port 
64H) or a data byte (port 60H) is involved. 


In addition to this flag, bits 0 and 1 of the keyboard status register are especially 
important for communication with the keyboard. Bit 0 indicates the status of the 
output buffer. If this bit is 1, then the output buffer of the keyboard contains 
information which has not yet been read from port 60H. Reading from this port 
will automatically set this bit back to 0, indicating that there is no longer a 
character in the output buffer. 


Bit 1 of the status register is always set whenever the system has placed a character 
in the input buffer, before this character is processed by the keyboard. Nothing 
should be written to the keyboard input buffer unless this bit is equal to 0, 
signalling that the input buffer is empty. 


1 O bit 
it | 1= Output buffer full _ 
1 = Input buffer full : 


Command/data 
1 = Output from port 64(h) 
0 = Output from port 60(h) 


1 = Keyboard active 
1 = Time out error (input) 


1 = Parity error 


AT keyboard controller status registers 


Of the various commands that a system can send to the keyboard, two are of 
interest for applications programs because they also play a roll outside a keyboard 
interrupt handler. The first of these commands sets the typematic or repeat rate of 
the keyboard. This is the number of make codes per second which the keyboard 
will send to the system when a key is pressed and held down. It can be between 
two and 30 codes per second. To prevent the keys from repeating unintentionally, 
this repeat function does not begin until after a certain delay. This delay time can 
be set by the user and is encoded in binary as follows: 
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rate 


[00(b)___ |. 1/4-second 


The keyboard will observe these times with a tolerance of +20%. 
The repeat rate, also called the typematic rate by IBM, is also encoded in binary. 


The following table shows the relationship between the repeat (typematic) rate and 
the number of repetitions per second. 


Phe ha 
co fata ito 
un 

ote lo 


\o 


Nik 
© 


oO 


RPS 

11111(b) | 2.0 [10111(b) | 4.0 [01111(b) | 8.0 | 00111(b) | 
11110(b) | 2.1 [10110(b) | 4.3 | 01110(b) | 8.6 | 00110(b) | 
11101(b) | 2.3 | 10101(b) | 4.6 | 01101(b) | 9.2 | 00101(b) | 
11100(b) | 2.5 |10100(b) | 5.0 | 01100(b) [10.0 
11011 (b) | 
11010(b) | 3.0 | 10010(b) | 6.0 | 01010(b) J12.0 | 00010 (b) 
11001(b) | 3.3 
11000 (b) 


NO FN 
oes Ce Loe 
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This relationship may seem somewhat arbitrary at first, but it does follow a 
mathematical formula. The binary value of bits 0, 1, and 2 of the repeat rate form 
variable A, and the binary value of bits 3 and 4 form variable B: 


(8 + A) * 2B * 0,00417 * 1/second 


The delay and repeat rate values are combined into a byte by placing the five bits 
of the repeat rate in front of the delay value. However, we can't just send this value 
straight to the keyboard. We must first send the appropriate command code (34H) 
and then the repeat parameters. Both bytes must be sent to port 60H, but we 
Cannot just send them with an OUT instruction. We have to use a transmission 
protocol which includes reading the keyboard status, and which also accounts for 
the possibility that the transfer might not work the first time. Since we have to do 
this for both bytes, we should write a subroutine to do it. The structure of this 
subroutine is shown in the following flowchart. _ 
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Error counter = 3 


Read keyboard 
status port 


in input 
buffer 


a characte Decrement 
acc 
epted error counter 


Error 
counter 


Okay, end 


0 
2 


YES 


Error, end 


Program flowchart—byte transfer via keyboard 
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We first load an error counter which allows the routine to try to send the byte three 
times before an error is returned. Then the keyboard status port is read in a loop 
until bit 0 is cleared and the input buffer of the keyboard is empty. Then we can 
send the character to port 60H. To make sure that the character got there all right (a 
parity error might have occurred, for example), the keyboard sends back a reply 
code. This has been received when bit 1 of the keyboard status port is set. 


This register is again read from port 64H in a loop until this condition is met. 
Now we can read the reply to our transmission from the keyboard data port. If it is 
the code OFAH, which stands for "acknowledge," the transmission was successful. 
Any other code indicates an error, which tells the subroutine to decrement the error 
counter and repeat the whole process, provided the counter has not reached zero. In 
this case the subroutine ends and signals an error to the caller. 


Demonstration programs 


To give you an example of how this works, the following pages contain programs 
in BASIC, Pascal, and C which you can use to set the key repeat parameters on 
your keyboard. The heart of these programs is an assembly language routine which 
sends the parameters to the keyboard. Within this routine is the subroutine we just 
discussed, which is first called to send the Set Typematic instruction to the 
keyboard. Another call is used to send the parameters themselves. 


In the Pascal and C versions, the key repeat rate and the delay values are specified 
as separate parameters following the program name entered at the DOS prompt. 
Naturally this is not possible in GW-BASIC, so the two parameters are read 
within the program with the INPUT command. 


We also included the listing of the assembly routines for the various programs. 
The BASIC and Pascal programs include these with DATA or INLINE statements; 
the linker links these statements to the C version of the program. 


To see the effect of the key repeat rate, first try setting the smallest repeat rate (0) 
and then the highest rate (30). Try pressing and holding a key at each of these 
settings to see the results. 


BASIC listing: TYPMB.BAS 


LOG PRAHA RHEE KEK KEKE KEKE KEK ERK EK EK KEKE KKK KEE KEK EEK EKEAKKEKKKKEKKE I 


110 '* TY PMB ws 
120 i a ee eee ee ea ee ewe eae ee ee ee xe 
130 '* Description : Sets the key repeat rate of the AT keyboard. *' 
150 '* Author : MICHAEL TISCHER * 
160 ‘* developed on : 09/08/1988 a 
170 '* last update : 09/08/1988 a 
180 CRAKE KKK REE KKH EKREKKREKAARKEREKREKAKKREKEEKEKEE 
190 ! 


200 CLS : KEY OFF 

210 PRINT “Note: This program may be run only if GWBASIC has been started"; 
220 PRINT “from the DOS level" 

230 PRINT “with the command <GWBASIC /m:60000> and the computer is an AT." 
260 PRINT : PRINT"If this is not the case, then please enter <s> for Stop." 
280 PRINT “Otherwise press any other key...";7 
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290 AS = INKEYS : IF A$ = “s“ THEN END 

300 IF AS = "“ THEN 290 

310 CLS ‘clear screen 
320 GOSUB 60000 ‘install assembler routine 
330 PRINT “TYPMB — (c)} 1988 by MICHAEL TISCHER" 

340 PRINT “Sets the repeat rate of the AT keyboard." : PRINT 

350 INPUT “Delay before repeat (O=minimum, 3=maximum) "“;V% 

360 IF V%<0O OR V%>3 THEN 350 

370 INPUT “Key repeat rate (30=minimum, O=maximum) ";W% 

380 IF W%<0 OR W%>30 THEN 370 

390 TYPRATES = V% * 32 + W% 

400 CALL TR(TYPRATE%, OK%) ‘set key repeat rate 

410 IF NOT OK% THEN 440 

420 PRINT “The key repeat rate has been set." 


430 END 

440 PRINT “Error accessing the keyboard controller.” 

450 END. 

460 ! 

60000 Pee ee eeceeeeee ee eee eee PPE See eee eee Pe eee eee SESE Se See ee Se ee ee ee ee 
60010 '* Install the routine for setting the key repeat rate. ms 
60020 8 8mm a a nn rn rn ere ne= x 
60030 '* Input =: none x 
60040 '* Output: TR is the start address of the assembler routine ae 
60050 ‘* Calling the routine: CALL TR(TYPRATE%, OK%) x 
60060 CW HKKKKKKKKKKEKKKKKEKKEKEKKKEKKEKEKEEKKEKKEKEKKEKKEKEKKEKREEKEKEKEKEKKKE I 
60070 ! 

60080 TR=60000! ‘start addr of the routine in the BASIC segment 
60090 DEF SEG ‘set BASIC segment 
60100 RESTORE 60140 

60110 FOR 1% = 0 TO 71 : READ X% : POKE TRtI%,X% : NEXT ‘poke routine 
60120 RETURN ‘back to the caller 
60130 ' 


60140 DATA 85,139,236, 51,210,180, 243,250,232, 23, 0,117, 11,139, 94 
60150 DATA 8,138, 39,232, 13, 0,117, 1, 74,251,139, 94, 6,137, 23 
60160 DATA 93,202, 4, 0, 81, 83,179, 3, 51,201,228,100,168, 2,224 
60170 DATA 250,138, 196,230, 96,228,100,168, 1,225,250,228, 96, 60,250 
60180 DATA 116, 7,254,203,117, 230,128,203, 1, 91, 89,195 


Assembler listing: TYPMBA.ASM 


FREAK KKK KEKE RE KEKE REE KKEKERKREEKEKREKKEKRERKKEEKEKKEKEKEKEEKKEKKEE 9 


7% TYPMBA *; 
3* cis ci ccs nis sc cums see ces Sam co us > SOO SURG Gum Gs Gm ik cen ccs as cis a eis cases ab ca em cis ee ss som Sc ui ech Sc cies ao in “Shc cS Ses Wms ss tn inn GCs se tems en Si a ns Ga tn we 
Peal Description : Assembler routine for use with a GWBASIC “s 
ee program, which sets the key repeat rate of the *; 
2* AT keyboard. x. 
se ‘rio ii cn mn ops i’ i ahi i neo i! as ts ia i is i i cis Sei a Am et tot ic ins i Sh i it Gu emi i an A em ie tm es i i ei ie el We 9 
3% Author : MICHAEL TISCHER we 
;* developed on : 27.08.1988 *; 
o* last update : 27.08.1988 * 
ox tsa tp iin sei i iin sn i SW i i i ie a i a in ih i i pt i si i lien is i Gs i ns a bh sh i ci wa ts mp ee cil oe ss ns is ee ws 
7* to assemble : MASM TYPMBA; *; 
Bs LINK TYPMBA *; 
om EXE2BIN TYPMBA TYPMBA.BIN ia 
o --. convert to DATA statements and insert in ¥*; 
3* a BASIC program if, 
FREER KEKKKKEKKEKKKEREKE KEKE EKKEEKERKEEKREKREKRKKEKKEEKKEKREKEEKEKREKEKKEKEREKEEKE 9 


KB STATUS P equ 64h 7Status port of the keyboard 

KB DATA P equ 60h ;keyboard data port 

OB_FULL equ 1 7Bit O in the keyboard status port 
7one character in the output buffer 

IB_ FULL equ 2 7;Bit 1 in the keyboard status port 


7one character in the input buffer 


ACK_ SIGNAL equ Ofah 7keyboard acknowledge signal 
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SET_TYPEM 


MAX TRY 


7== Program code 


e 


equ Of3h 


qu 3 


;set-key-repeat code 


snumber of retries 


SSS SS SSS SVT SSK TTS SEES SSS SS LS SS TSS 


;definition of the CODE segment 


Determines the key repeat rate to be sent to the 


If the key repeat rate can be set, the value will be 


7;GW expects FAR procedures 
;structure for accessing the stack 


;return address to the caller 

; (FAR address) 

jaddress of the OK variable 

;address of the var with the rep rate 
7end of the structure 


;addresses the elements of the structure 


;save BP on the stack 
;transfer SP to BP 


yassume transfer failed 

;set command code for key rep rate 
;disable interrupts 

;send to the controller 

7error? yes --> Error 


7get address of the TYPRATE variable 
7get key repeat rate 

7send to the controller 

7error? yes --> Error 


;everything OK, return -1 


yallow interrupts again 

;get address of the OK variable 
;put error static there 

7get BP back from stack 

zback to GW-BASIC and remove the 
;variables from the stack 


this routine is intended for use only within this 


7save all registers used in this 


code segment para ‘CODE‘ 
org 100h 
assume cs:code, ds:code, ss:code, es:code 
f 
p-- SET TYPM: 
;-— keyboard controller 
zyo- Call : CALL Adresse (TYPRATE%, OK%) 
f-—- Info : 
eee Placed in TYPRATE, else 0 
set_typm proc far 
sframe struc 
bptr dw ? 7stores BP 
ret_ adr dd ? 
ok_adr dw ? 
tr adr dw ? 
sframe ends 
frame equ { bp - bptr ] 
push bp 
mov bp,sp 
xor dax,dax 
mov ah,SET TYPEM 
cli 
call send kb 
jne error 
mov bx, frame.tr adr 
mov ah, [bx] 
call send_kb 
jne error 
dec dx 
error: sti 
mov bx, frame.ok adr 
mov {bx],dx 
pop bp 
ret 4 
set typm  endp 
’ 
7~~- SEND _KB: send a byte to the keyboard controller 
g7—- Input : AH = the byte to be sent 
7-—- Output : zero flag: O=error, 1=OK 
7-- Registers: AX and the flag register are used 
7-- Info : 
= module 
send kb proc near 
push cx 
push bx 


mov bl,MAX TRY 


;routine on the stack 


7maximum of MAX TRY retries 
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;-- wait until the controller is ready to receive data ------- 


skb 1: xor CX,Cx 7maximum of 65536 loop passes 
skb 2: in al,KB STATUS P 7;read contents of the status port 
test al,IB FULL zstill a character in the input buffer? 
loopne skb 2 zyes --> SKB 2 
7-~ send character to the controller ------------------------- 
mov al,ah ;get character in AL 
out KB DATA P,al 7send character to the data port 
skb_ 3: in al,KB STATUS P ;read contents of the status port 
test al,OB FULL sanswer in the output buffer? 
loope skb 3 7no --> SKB 3 
7-- get reply from controller and evaluate --~--<--------------- 
in al,KB DATA P ;read reply from data port 
cmp al,ACK SIGNAL ;was the character accepted? 
je  skb_end 7YES --> everything OK 
;-~- the character was not accepted -----3 nnn en rr 
dec bl ;Gecrement error counter 
jne skb 2 ;retries left? 
7YES --> SKB 2 
or bl,l 7NO, set zero flag to 0, indicating 
gan error . 
skb end: pop bx ;restore the registers from the stack 
pop Cx 
ret zback to the caller 


send kb endp 


code ends 7end of the code segment 
end set_typm 


Pascal listing: TYPMP.PAS 


{RR HKKKKKHKKEKKKKKKK KKK KEKE KKEKKKKK KKK KKK AKER KEKE KHKKKKERKKEEKKKEKKKK | 
{* TY PMP *} 
{* ak cs sees ess ao is ms es ln ins ais ems om ents as cc ns tsi aos aw nb Sins cos cea cine eed sas tnt a cs is Swi ese ce cn es cin es hss es iw tes toes ow eds et cams insn saw aoe eae *} 
{* Description : Sets the key repeat rate of the AT keyboard. *} 
{* Ss ce i ck oi sk Sins le ee ms ses is ecm cess as Sse cs eka ln inset Se ne San ca es a sn fs ea ss ‘wis els nes Us cn cos meen a te Ses et tes Sh ws Se a a *} 


{* Author : MICHAEL TISCHER =} 
{* developed on  -: 08/27/1988 *} 
{* last update : 08/27/1988 *} 


[RA KKKKKKEKKKEKKKKRKIKKEKKKEKKKKEKKKKEKAKKKKEKEKAKKEKKEKEEEKKKEKKEHKEKRKEKEKKEEKEKEE | 


program TYPMP; 


{ARKH A KKK KEK KKK KKK KE KHIR KK KKK EKER EKER RK KEEKKKKKEKRKEKEEKKEKKEKKEKE | 


{* SetTypm: Sends the key repeat rate to the keyboard controller *} 
{* Input : RATE : the repeat rate to be set *} 
{* Output : TRUE, if the value was set, FALSE if an error occurred *} 
{* accessing the controller *} 
{* Info : This function can be bound into a UNIT *} 


{ RE RRKEKKKKEKEKKREK HERE KEK KEEKEKERE KEKE KEKE KEREKEEREREEEEKKREKEEKEEKEKKKEKEEKE | 
{SF+} { this function uses the FAR call model } 
function SetTypm( Rate : byte ) : boolean; 

begin 


inline ( 
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$32/$D2/$B4/SF3/S$FA/SE8/$13/$00/$75/S0A/S$8A/$66/$06/$E8/ 
$0B/$00/$75/$02/SFE/$C2/SFB/$88/$56/SFF/SEB/$27/$90/$51/ 
$53/$B3/$03/$33/$C9/$E4/$64/$A8/$02/SE0/SFA/$8A/$C4/SE6/ 
$60/SE4/$64/SA8/$01/SE1/SFA/S$E4/$60/$3C/SFA/$74/$07/SFE/ 
$CB/$75/$E6/$80/$CB/$01/$5B/$59/$C3 
)e 
end; 


{SF-} 


[RARER RRR RK KHER EKER IK EI K KK KKK KER KKK KKK K KK KAKA AEKRKEKEKERKEKKKKKE | 


{** MAIN PROGRAM we) 


{RR AR RRR KKK EKER EKER K ERE REKRERKEREEEKEREREREREEEREEKEKREKKEKEE 


var Delay, { stores the delay } 
Speed, { stores the key repeat rate } 
Fposl, 
FPos2 : integer; { error position in string conversion } 
ParErr : boolean; { error in parameter passing } 
begin 
writeln(#13#10, ‘'TYPMP - (c) 1988 by MICHAEL TISCHER'); 
ParErr := true; { assume error in parameters } 
if ParamCount = 2 then { were 2 parameters passed? } 
begin { YES } 
val (ParamStr(1}), Delay, FPos1); { first parameter to integer } 
val (ParamStr (2), Speed, FPos2)}; { second parameter to integer } 
if ((FPosi=0) and (FPos2=0)) then { error in conversion? } 
if ((Delay < 4) and (Speed <32)) then { no, value OK? } 
ParErr := false; { yes, then parameters are OK } 
end; 
if ( ParErr ) then { are parameters OK? } 
begin { no } 
writeln(Call : TYPMP delay key repeat rate‘); 
writeln(' ', #30,' ', #30); 
writeln(' | I"); 

{* Vertical line can be created using <Alt><179>; *} 
writeln(' [————_—_—__—----] [-------1-----------]"); 

{* Upper left corner can be created using <Alt><218>; *} 

{* Horizontal line can be created using <Alt><196>; *} 

{* Brace pointing ‘up' can be created using <Alt><193>; *} 

{* Upper right corner can be created using <Alt><191> *} 
writeln(' | 0 : 1/4 second | | 0 : 30.0 rep./s. I'y; 

{* Vertical line can be created using <Alt><179>; *} 
writeln(' | 1:1/2 second | | 1: 26.7 rep./s. |); 
writeln(' | 2 : 3/4 second | | 2: 24.0 rep./s. I"); 
writeln(' | 3: 1 second | | 3: 21.8 rep./s. I"); 
writeln(' { oa + - -- { | . l'); 

{* Left brace can be created using <Alt><195>; *} 

{* Horizontal line can be created using <Alt><196>; *} 

{* Right brace can be created using <Alt><180>; *} 
writeln(' | all values q20% | | ‘ I"); 
writeln(' | -------~~----------- J | F I"); 

{* Lower left corner can be created using <Alt><192>; *} 

{* Horizontal line can be created using <Alt><196>; *} 

{* Lower right corner can be created using <Alt><217>; *} 
writeln(' 128: 2.5 rep./s. It); 

{* Vertical line can be created using <Alt><179>; *} 
writeln(' 29+: 2.3 rep./s. It); 
writeln(' 130: 2.1 rep./s. I"); 
writeln(' [31 : 2.0 rep./s. I"); 
writeln(' | ------------------- J); 

{* Lower left corner can be created using <Alt><192>; *} 

{* Horizontal line can be created using <Alt><196>; *} 

{* Lower right corner can be created using <Alt><217>; *} 

end 
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else { the parameters are OK } 
begin 
if (SetTypm( (Delay shl 5) + Speed )) then { set key repeat rate } 
writeln('The keboard repeat rate was set.') 
else 
writeln('ERROR accessing the keyboard controller.'); 
end; 
end. 


Assembler listing: TYPMPA.ASM 


FRR RKREREKRK EERE IKKE EK KEKE KKK ERK KKERKK KKK EKER EREREEKKEEEEKKERE KK 5 
2 TY PMPA “7 
Hig a we cam ane en SEY UD ED ce AD OO CED ED GERD COEDS) SEED See GD SO CEE SEND GE ND GN ND GOED FED SNE GA SE) SEED VE EG SONG SD SED ERD Ei ED GORD TY QED SPD SEED ED OD ANA OU SANE SD SHED SED SENS SEND GON GA > nD EN NY ee 
-* Description : Assembler routine for use with a Turbo Pascal ws 
7” program, which sets the key repeat rate of the *; 
zt AT keyboard. bai 
= sa ein ci is em iy er el eh ii nih ca we hs tsi vie i ci tl wis wi iscsi im Wi i fe mm i hi tt te i i i ia in Wl lh sun nam Sm em el ee is *s 
rhs Author : MICHAEL TISCHER *s 
3* developed on : 27.08.1988 iar 
hl last update : 27.08.1988 - 
s* isms in sees i cos enti une ses iu Sn tps cies‘ ewe Gate egies Sow eu ue sis un rs sow ei i diye i vu Sis nn aw sions‘ semi as nn Gumus beheaded Stas et ei mec is ei i cen es airs 
:* to assemble : MASM TYPMPA; iar 
a LINK TYPMPA a 
= EXE2BIN TYPMPA TYPMPA.BIN *3 
ies -.-. convert to INLINE statements *; 

ox 

LA 


HHKKKKKKKEK KKK KK ER KEEKKEKK KEKE KEKE EEE ERK KKEKKEKRKKKEKEKKEKEKRKKEREKEKEKEKE » 


KB STATUS _P equ 64h ;status port of the keyboard 

KB DATA P equ 60h ;keyboard data port 

OB FULL equ 1 ;Bit O in the keyboard status port 
7one character in the output buffer 

IB_ FULL equ 2 ;Bit 1 in the keyboard status port 
yone character in the input buffer 

ACK SIGNAL equ Ofah 7keyboard acknowledge signal 

SET_TYPEM equ Of3h ;set-key~repeat code 

MAX TRY equ 3 ;number of retries 


code segment para 'CODE' ;definition of the CODE segment 
org 100h 


assume csS:code, ds:code, ss:code, es:code 


;-~ SET _TYPM: Determines the key repeat rate to be sent to the -------- 
j-- keyboard controller 
j-- Info : Set up as a NEAR call 
set_typm proc near 7;GW expects FAR procedures 
sframe0 struc ;structure for accessing the stack 
bpd dw ? ;stores BP 
ret_adrO dd? ;return address to the caller 
; (FAR address) 
trated dw ? yaddress of the var with the rep rate 
sframeO ends zend of the structure 
frame equ [ bp - bpd ] jaddresses the elements of the structure 


7The following instructions are executed by Turbo 
push bp ;save BP on the stack 


=e 
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=e 


error: 


mov bp,sp ;transfer SP to BP 

xor dl,dl sassume transfer failed 

mov ah,SET_ TYPEM ;set command code for key rep rate 
cli ;disable interrupts 

call send_kb ssend to the controller 

jne error ;error? yes --> Error 


mov ah,byte ptr frame.trate0 ;get address of the TYPRATE variable 


call send_kb ssend to the controller 
jne error ;error? yes --> Error 

inc dl peverything OK, return TRUE 
sti jallow interrupts again 
mov [bp-1],dl ;put error static there 
pop bp 7get BP back from stack 
jmp ende zback to Turbo Pascal 
endp 


77~— SEND _KB: send a byte to the keyboard controller -------<------------—- 


77-~- Input 


s-- Output 


: AH = the byte to be sent 
zero flag: O=error, 1=OK 


-- Registers: AX and the flag register are used 


g 
7 
77-- Info 
? 


skb 3: 


skb_ end: 


send_kb 


this routine is intended for use only within this 


module 
proc near 
push cx ;save all registers used in this 
push bx ;routine on the stack 
mov bl,MAX TRY ;maximum of MAX TRY retries 


j-- wait until the controller is ready to receive data ------- 


xOor cCx,Cx ;maximum of 65536 loop passes 

in al,KB STATUS P ;read contents of the status port 

test al,IB FULL zstill a character in the input buffer? 
loopne skb 2 ryes --> SKB 2 


j-- send character to the controller ------------------------- 


mov al,ah 7get character in AL 

out KB DATA P,al ;send character to the data port 
in al,KB STATUS P ;read contents of the status port 
test al,OB FULL yanswer in the output buffer? 
loope skb 3 ;no --> SKB 3 


;-- get reply from controller and evaluate ------------------- 


in  al,KB DATA P ;read reply from data port 

cmp al,ACK SIGNAL ;was the character accepted? 

je skb_end ;YES --> everything OK 

;-~ the character was not accepted ------------------—--------- 
dec bl ;decrement error counter 

jne skb 2 yretries left? 


7YES --> SKB 2 


or bi,l ;NO, set zero flag to 0, indicating 
yan error 


pop bx ;restore the registers from the stack 
pop cx 

ret ;back to the caller 

endp 
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ende label near 
code ends z;end of the code segment 


end set _typm 


C listing: TYPMC.C 


[ RRKKKKREKKREKKEKEK EKER KEKE KEK KEKE KEKE KEKE KKK KEKE EKER KEEEKEKEREKEK / 


/* TY PMC */ 
/* oe ae ee ca A ee a a OS cee Se Se SO Se SS ECE SES SS SD SDS SND DD OND MD ND IO SN SOND SP ED ED OS ce ND a/ 
/* Description : Sets the key repeat rate on the AT keyboard */ 
/* according to the preferences of the user. «/ 
/* hs cs ns Ss ss as hs as cm in ets usa es hve mm in ss ves Ses Sun em in cessing utc cass bm Sm ws as tm Sims uch oma iis Gc cs Qin Gls sun eppenb bie aos eh nice Sa eo a/ 
i* Author : MICHAEL TISCHER #7 
/* developed on : 08/28/1988 =] 
,* last update : 08/28/1988 */ 
/* oe oe ce ee ee Ce Sm eee ey aD Ean CLT CED EE ND SEED Cte GND EY AAR Ce IED Ht GD SES ND GND SND SRS ECD SDE CT GERD SD GND HED ED OND ED SEND SE GED SU GCE SD SEN EDD SnD SEM EDD cts GID ND EAN ERED GUND SD E> nts xf 
/* (MICROSOFT C) ui 4 
7* creat ion : CL /AS /c TYPMC.C */ 
’ he LINK TYPMC TYPMCA; *7 
/* call : TYPMC */ 
/* cin ar us ei er it enh nk us nin ce us cei us vs ta ss ws malo‘ meme wc sm Sn min’ ce mn <i oem es ene i er meh Se uh ss emma sm a it eh ann */ 
{* (BORLAND TURBO C) oy, 
Z* creation : via project file with following contents: */ 
(es TYPMC xy, 
/* TYPMCA. OBJ */ 


[ ERRKRKEKKKKKAKKKEEK EKER KKK KERKIEK EK IKKE KEK EKER EK EKER KEKEKEKEEKKEKKKKE / 


#include <stdlib.h> 


typedef unsigned char byte; /* build ourselves a byte */ 
typedef byte bool; /* always TRUE or FALSE */ 
#define TRUE 1 /* needed for working with BOOL */ 
#define FALSE 0 

/*== Declaration of external functions in the assembler module =======*/ 
extern bool set _typm( byte trate ); /* sets the key repeat rate */ 


[RRR RRR RIK IK KIKI IAI TKI KHIR IIH KIKI KEI AIKRI KEKE KKK KK | 


sas MAIN PROGRAM we 4 


[RRR KIRK KIKI KIKI IKK III KK KKK IARI KIKI IKK KIK HEIKKI KAKI KEKE KK 


void main(int argc, char *argv[] ) 
{ 
int delay, /* stores the specified delay */ 
speed; /* stores the specified repeat rate */ 


printf("\nTYPMC - (c) 1988 by MICHAEL TISCHER\n") ; 
if (arge!=3 || ( (delay = atoi(argv{1]))<O || delay>3 ) |] 
( (speed = atoi(argv[2]}}<O |] speed>31 })) 

{ /* illegal parameters were passed */ 
printf ("call: TYPMC delay key repeat _rate\n"); 
printf (" \xle \xle\n") ; 
printf (" | Nn"); 

/* Vertical line can be created using <Alt><179>; «/ 


peinee(e. fede a ee eye 
/* Upper left corner can be created using <Alt><218>; */ 


586 


Abacus 12. Keyboard Programming 


/* Horizontal line can be created using <Alt><196>; */ 
/* Brace pointing ‘up' can be created using <Alt><193>; ud 
/* Upper right corner can be created using <Alt><191> Le A 
printf (" | 0 : 1/4 second | | 0 = 30.0 rep./s. Kn"); 
/* Vertical line can be created using <Alt><179>; */ 
printf (" | 1: 1/2 second | | 1: 26.7 rep./s. Kn"); 
printf (" | 2 : 3/4 second | | 2: 24.0 rep./s. Kn"); 
printf (" | 3:1 second | | 3: 21.8 rep./s. An"); 
printf (" { ----------------~------~ { | ° An"); 
/* Left brace can be created using <Alt><195>; */ 
/* Horizontal line can be created using <Alt><196>; n/ 
/* Right brace can he created using <Alt><1B80>; */ 
printse (™ | all values q20% | | : Kn"); 
printf (" | ------------------ —j | . Kn"); 
/* Lower left corner can be created using <Alt><192>; iF 
/* Horizontal line can be created using <Alt><196>; */ 
/* Lower right corner can be created using <Alt><217>; ad 
printf (" | 28 : 2.5 rep./s. Kn"); 
/* Vertical line can be created using <Alt><179>; */ 
printf (" |29 : 2.3 rep./s. Kn"); 
printf (" [30 : 2.1 rep./s. \n") > 
printf (" [31 : 2.0 rep./s. Kn") ; 
printf (" | ------~------------ Kn"); 
/* Lower left corner can be created using <Alt><192>; il 4 
/* Horizontal line can be created using <Alt><196>; sf 
/* Lower right corner can be created using <Alt><217>; “/ 
} 
else /* the parametes are OK */ 
{ 
if (set_typm( (delay << 5) + speed )) /* set repeat rate */ 
printf ("The keyboard repeat rate was set.\n"}; 
else 


printf ("ERROR accessing the keyboard controller.\n"); 
} 
} 


Assembler listing: TYPMCA.ASM 


HK KIKI KKK IKI KK KKK III IIH KKK IKEA KEK KKK KKK KKK KKK KKEKEKKKEKKKKKKE © 
k 


TY PMCA 
Description : Assembler routine for setting the key repeat 
rate on an AT keyboard. For linking with a 
C program. 


* 


+ 
» 
"=e “ee 38 3 


‘ + + 
! 
1 
{ 
{ 
| 
J 
! 
| 
! 
t 
! 
| 
1 
! 
! 
! 
! 
! 
! 
1 
{ 
{ 
! 
I 
! 
! 
i 
t 
| 
! 
t 
| 
{ 
i 
t 
I 
! 
! 
! 
t 
| 
| 
! 
! 
! 
t 
! 
! 
! 
| 
1 
! 
{ 
i 
! 
! 
t 
j 
1 
! 
{ 
i 
! 
1 
! 
! 
J 
+ oF 


—™e “Ne Me Re Ns We Ve Ve Ve VWs Ve Veo Ve We 
™e “Ss Ne Ve We Re VW 


ms Author : MICHAEL TISCHER * 
* developed on : 08/27/1988 . 
* last update : 08/27/1988 x 
I a i ses ss cm Sa ne cn a ec es So Ss as is ec as es Se ta es ea ms ea a dS ewe ves es oe ee ee ee a ee eee t 
ii to assembler +: MASM TYPMCA; *; 
i --- link with a C program *; 
* 


KHER KEKE KEE KKK KARE R EK KKK EKER IKKE KEKE EERE KREKK EERE AEK ER EEE 0 


intel Constants ool SSS SS SS SS SS SS SS SS SS SS SS SS LS LS LS LS SS LS SS SS LS SS LS TS SF LS LS SS SS SS SS SS SSS 
KB STATUS P equ 64h ;keyboard status port 
KB DATA | equ 60h ; keyboard data port 
OB_FULL equ 1 zbit O in keyboard status port 
za character in the output buffer 
IB FULL equ 2 sbit 1 in the keyboard status port 
ja character in the input buffer 
ACK SIGNAL equ Ofah ; keyboard acknowledge signal 
SET_TYPEM equ Of3h ;set-repeat-rate code 
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MAX TRY equ 3 snumber of retries allowed 


IGROUP group text ;combination of the program segments 
DGROUP group const, bss, data scombination of the data segments 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public 'CONST';this segment stores all of the 
CONST ends ;read-only constants 


_BSS segment word public 'BSS' ;this segment stores all of the 
_BSS_ ends suninitialized static variables 


_DATA segment word public 'DATA' ;all initialized global and static 
;variables are stored in this segment 
_DATA ends 


= PYOQLaN SHH Ss22SSSSSs SSeS SS SSS SS SSS SS SSS SSS SSS SSS SSS SSS SS 
_TEXT segment byte public 'CODE' ;the program segment 


public _set_typm 


~~ SET _TYPM: sends the key repeat rate to the keyboard controller ----- 
Call from C : bool set_typem( byte trate ); 

-~ Return value: TRUE, if the repeat rate was set 

FALSE, if an error occurred 


_set_typm proc near 


sframe0 struc ;structure for accessing the stack 
bpd dw ? ;stores BP 
ret_adrO dw ? ;return address to caller 
trated dw ? ;repeat rate to be set 
sframe0 ends rend of the structure 
frame equ [ bp — bp0d } jaddresses the elements of the structure 
push bp z;save BP on the stack 
mov bp,sp ;transfer SP to BP 
xor dx,dx ;assume transfer fails 
mov ah, SET TYPEM ;set command code for rep rate 
cli ;disable interrupts 
call send_kb ;send to the controller 
jne error yerror? YES --> Error 


mov ah,byte ptr frame.trateO ;get key repeat rate 


call send kb ;send to the controller 

jne error yerror? YES <--> Error 

inc dl ;everything OK, return TRUE 
error: sti ;allow interrupts again 

mov ax,dax ;return value to AX 

pop bp 7get BP back from stack 

ret ;back to the C program 


_set_typm endp 


-- SEND KB: send a byte to the keyboard controller -------------------- 
: AH = the byte to be sent 
-- Output : zero flag: O=error, 1=OK 
~- Registers: AX and the flag register are changed 
Info : This routine is to be called only within the module 


“se Se “Ne Se Ve 


send_ kb proc near 
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skb_ 
skb __ 


Ne 


skb 3: 


skb_end: 


send kb 


push cx ;save all registers which are changed 
push bx sin this routine on the stack 
mov bl,MAX TRY zmaximum of MAX TRY retries 


y-- wait until the controller is ready to receive data ------ 


xor CxX,Cx ;maximum of 65536 loop passes 

in al, KB STATUS P jread contents of status port 

test al, IB FULL sstill a char in the input buffer? 
loopne skb 2 7YES --> SKB 2 


z-- send character to the controller -------------<-<<--------- 


mov al,ah zget character in AL 

out KB DATA P,al zsend character to the data port 
in al,KB_ STATUS _P ;read contents of the status port 
test al,OB FULL 7reply in output buffer? 

loope skb 3 7NO --> SKB 3 


77- get and evaluate relpy from controller ------------------- 


in al,KB DATA P ;read reply from data port 
cmp al,ACK SIGNAL ywas the character accepted? 
je skb_ end 7;YES --> everything OK 


7-- the character was not accepted ~---------~--- =n 


dec bl ;decrement error counter 
jJne skb 2 still retries left? 
7YES --> SKB 2 


or bl,l ;NO, set zero flag to 0 to indicate 
;the error 
pop bx ;restore the registers from the stack 
pop cx 
ret s;return to caller 
endp 
ends send of the code segment 
end 7end of the program 


We can use this same method to turn the LEDs on the AT keyboard on and off. 
The corresponding instruction code is number OEDH, and is called the Set/Reset 
Mode Indicators instruction. 


After this command code has been successfully transmitted, the keyboard waits for 
a byte which reflects the status of the three LEDs. One bit in this byte stands for 
one of the three LEDs, which is turned on when the corresponding bit is set. 


Scroll Lock 
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Setting and resetting these bits make sense only when the keyboard mode which 
they indicate is enabled or disabled. 


These modes are managed in the BIOS, not the keyboard. For example, the 
keyboard doesn't automatically convert all of the letters to uppercase in Caps Lock 
mode. The keyboard can only associate a key with a virtual key number, rather 
than a specific character. This key number is then converted to an ASCII or 
extended keyboard code by the BIOS. Naturally this also applies to the Caps Lock 
key, which simply sends a scan code to the computer when it is pressed. The BIOS 
assigns the Caps Lock function to this key by setting an internal flag which marks 
this mode as active, then sends the Set/Reset Mode Indicators instruction to the 
keyboard to light the appropriate LED. 


Although these keyboard modes are normally enabled and disabled by the user 
pressing the corresponding keys, it may be useful to set a mode from within a 
program. This is the case for keyboards which have separate cursor keys and a 
numerical keypad, for example. Since most keyboards can only enter numbers 
when Num Lock mode is on, it makes sense to set this mode automatically when 
the system is started. 


To do this we just set the appropriate BIOS flag and then turn on the 
corresponding LED on the keyboard to inform the user that this mode has been 
activated. 


In practice, a program just has to set the appropriate BIOS mode, since the BIOS 
automatically controls the keyboard LEDs. Whenever one of the functions of the 
BIOS keyboard interrupt is called, the BIOS checks to see if the status of the LEDs 
matches the keyboard status, as indicated in an internal variable. If a discrepancy 
arises, the BIOS automatically sets the LEDs to the status given in the keyboard 
Status flag. 


Since the position of this flag in the BIOS variable segment and the meaning of 
the individual bits is completely documented (see also Section 7.14), we can easily 
change these modes. 


The following programs in BASIC, Pascal, and C offer routines which can enable 
or disable the individual modes. It should be noted that although PCs and XTs 
have corresponding LEDs, these programs will not work or change the modes 
without changing the status of the LEDs on a PC or XT keyboard. This is because 
these keyboards are equipped with an 8048 processor, which does not offer the 
ability to manage the LEDs. The fact that these LEDs do tum on and off according 
to the modes has nothing to do with the BIOS, and is handled directly by the 
keyboard. 
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BASIC listing: LEDB.BAS 


100 '* 
110 ** 
120 ‘* 
130° ** 
140 '* 
150 '* 
160 ‘'* 
170 '* 
180 ‘* 
190 ‘* 


AAN 6 
avy 


HHA KKHK KERR KKK KEEKEKKEKKEKEEKKKEEKREEKEREKEKKKKKREKEKEEKEKEKEK 


LEDB wa 


xe 


Description : Sets the various bits in the BIOS keyboard = 


flag, causing the LED's on the AT keyboard *' 
to flash. "* 
Author : MICHAEL TISCHER lag 
developed on : 09/10/1988 “! 
last update : 09/10/1988 x 


PETES STCCCCCCCOCSCSCCCOCSCOCCSCSOSCCOCSCCCC CCS OSS CS SP Pe Cee Pe ee ee er ta 


210 CLS : KEY OFF 


220 PRINT 


230 PRINT "the DOS level with the command <GWBASIC /m:600000> and the" 
240 PRINT “computer is an AT." 

250 PRINT 

260 PRINT “If this is not the case, please enter <s> for STOP." 

270 PRINT “Otherwise press any other key...“; 

300 AS = INKEYS : IF A$ = “"s" THEN END 

310 IF AS = "" THEN 300 

320 CLS 


330 GOSUB 60000 


‘install routine for the interrupt call 


340 PRINT “LEDB - (c) 1988 by MICHAEL TISCHER" 
350 PRINT : PRINT “Watch the LEDS on your keyboard!" 


360 SCRL& = 16 ‘the SCROLL LOCK flag 
370 NUML% = 32 ‘the NUM LOCK flag 
380 CAPL& = 64 ‘the CAPS LOCK flag 


390 FOR X% = 1 TO 10 


“NOTE: This program can be run only if GWBASIC was started from" 


400 FLAGS% = CAPL% : GOSUB 50000 
410 FOR Y% = 1 TO 100 : NEXT 

420 GOSUB 51000 

430 FLAGS&$ = NUML% : GOSUB 50000 
440 FOR Y&$ = 1 TO 100 : NEXT 

450 GOSUB 51000 

460 FLAGS%$ = SCRL% : GOSUB 50000 
470 FOR Y$ = 1 TO 100 : NEXT 

480 GOSUB 51000 

490 NEXT 


5900 FLAGS%$ = SCRL& OR NUML% OR CAPLS% 
910 FOR X% = 1 TO 10 


‘run through the loop 10 times 
‘set CAPS LOCK 

‘delay loop 

‘CAPS LOCK off again 

‘set NUM LOCK 

‘delay loop 

"NUM LOCK off again 

‘set SCROLL LOCK 

‘delay loop 

"SCROLL LOCK off again 


‘manipulate all three flags 
‘run through loop 10 times 


520 GOSUB 50000 ‘set all three flags 
530 FOR Y% = 1 TO 400 : NEXT ‘delay loop 
540 GOSUB 51000 ‘clear all flags again 
550 FOR Y$ = 1 TO 400 : NEXT ‘delay loop 
560 NEXT 

570 PRINT "That's all." 

580 END 

590 ! 

50000 DWM KEK IKI KKK KK IKK KEK KKK KKK KEKE KKK EK KEK KKK KEKKEKKEEKKKEKKKKEKKK I 
50010 ** set one or more of the flags in the BIOS keyboard status La 
50020 !*---~--~+-------~--—~~-- + -- - -- - nr nee “0 
50030 '* Input : FLAGS% = the flags to be set oe 
50040 '* Output : none = 
50050 '* Info : the variable 2% is used as’a dummy variable = 
50060 CHK HK KAKI KKK KKK KKKKKKKKEE KK KKKKKKKEKKEKKEKEKEKKKKEEKKKEKKKKKEKS 
50070 ! 

50080 DEF SEG = &H40 ‘set BIOS variable segment 
50090 POKE &H17, PEEK(&H17) OR FLAGS% ‘set the flags 
50100 INTR% = &H16 ‘call BIOS keyboard interrupt 
50110 AH% = 1 ‘function 1: character ready? 
50120 DEF SEG ‘switch back to the GW segment 
50130 CALL IA(INTR&,AH%, 2%, 2%, 2%, 2%, 2%, 2%, Z%, 2%, Z%, Z%, 2%) 

50140 RETURN ‘back to the caller 
50150 ! 

51000 THM KKK KKK IKEA KKK KKK KKK KKK KK KAKA KKKKEKKKKKKKEKKKKKAKKEKK KKK 
51010 '* clear one or more the flags in the BIOS keyboard status =D 
51020 8 8a a a a er nr nner - 
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51030 '* Input : FLAGS% = the flags to be cleared ae 
51040 ** Output =: none oi 
51050 '* Info : the variable 2% is used as a dummy variable i 
51060 EHH HK HK KKK KEK KEK KKK KKK KEKE KKEKKEEKEKKKKEEKKKKEKEKEEKRKKEKKKKKAKKEKKKEEK 
51070 ! 

51080 DEF SEG = &H40 ‘set BIOS variable segment 
51090 POKE &H17, PEEK(&H17) AND NOT (FLAGS%) ‘clear the flags 
51100 INTR% = &H16 ‘call the BIOS keyboard interrupt 
51110 AHS = 1 ‘function 1: character ready? 
51120 DEF SEG ‘switch back to the GW segment 
51130 CALL IA(INTR%,AH%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%, 2%) 

51140 RETURN "back to the caller 
51150 ! 

60000 CHEK KKKEKEKKEKKEKEKEKEKEKEKREKKKEKKEKKEKKCEKKEKKEKKKKKKKKEKERERKKKEKEKEKKKKE 
60010 '* initialize the routine for the interrupt call “es 
60020 '*--~--~--—~~~—-—~-~—--~-~---—- —- -— — —- - - $n nn rns “e 
60030 '* Input : none = 
60040 '* Output : IA is the start address of the interupt routine talks 
60050 DWH HK KKK KK KKK KKK KKK KKK KKK KKKEKEKKKKKKKEKEKKEKKKKKEKKKEKKKKKKKKKEKS 
60060 ! 

60070 IA=60000! ‘start address of the routine in the BASIC segment 
60080 DEF SEG ‘set BASIC segment 


60090 RESTORE 60130 

60100 FOR I% = 0 TO 160 : READ X% : POKE IA+I%,X% : NEXT ‘poke routine 
60110 RETURN ‘back to the caller 
60120 ! 

60130 DATA 85,139,236, 30, 6,139,118, 30,139, 4,232,140, 0,139,118 
60140 DATA 12,139, 60,139,118, 8,139, 4, 61,255,255,117, 2,140,216 
60150 DATA 142,192,139,118, 28,138, 36,139,118, 26,138, 4,139,118, 24 
60160 DATA 138, 60,139,118, 22,138, 28,139,118, 20,138, 44,139,118, 18 
60170 DATA 138, 12,139,118, 16,138, 52,139,118, 14,138, 20,139,118, 10 
60180 DATA 139, 52, 85,205, 33, 93, 86,156,139,118, 12,137, 60,139,118 
60190 DATA 28,136, 36,139,118, 26,136, 4,139,118, 24,136, 60,139,118 
60200 DATA 22,1236, 28,139,118, 20,136, 44,139,118, 18,136, 12,139,118 
60210 DATA 16,136, 52,139,118, 14,136, 20,139,118, 8,140,192,137, 4 
60220 DATA 88,139,118, 6,137, 4, 88,139,118, 10,137, 4, 7, 31, 93 
60230 DATA 202, 26, 0, 91, 46,136, 71, 66,233,108, 255 


Pascal listing: LEDP.PAS 


{ BHAA RRR EKER KKK ERE KEE KEK ERK EEE KKK ERK KEKKKEKK EEK KEKKKEKKEKEKEKKKEER } 


{* LED P *} 
{* ae me en ae er a em te ee ne ee ee See ne a ne ee MY me ce ee me ce ee a Se Ef eA ee Lc Dh eS eA YM en oe cone en ae ee ae *} 
{* Description : sets the various bits in the BIOS keyboard *} 
es status byte causing the LEDs on the AT x} 
i* keyboard to turn on. *} 
{* i es ce a ce ate a ce ne ae ee ee ee ee ree ee ee eee ee ce re cee cen ee ne nee ee ee ce ee ce me ee ee ne ne ee ee en a ee ane me co ee ee *} 
t Author : MICHAEL TISCHER P| 
{* developed on : 08/16/1988 ; x 
{* last update : 08/17/1988 *} 


{ RRR RR HERR RKRE KEKE EKER EKER EKER KKK HK KEKE KKK KEKE IKKE KKKKKEKKKKEEEKEKKKKKKEE | 


program LEDP; 


uses CRT, { bind in the CRT unit } 
DOS; { bind in the DOS unit } 
const SCRL = 16; { Scroll Lock bit } 
NUML = 32; { Num Lock bit } 

CAPL = 64>; { Caps Lock bit } 

INS = 128; { Insert bit } 


{ERR KKEK KEK KKK KER KKK KEK KEK KKK KKK KKK KE KKKKKAKKKKKKEES | 


{* SETFLAG: sets one the flags in the BIOS keyboard status byte ae | 
{* Input : the flag to be set (see constants) ‘ *} 
{* Output : none *} 


{ BERRA IRR RE RIR RIKER EKER KEIRA RK KIK ERE KERIKERI EKREREKE KE | 


procedure SetFlag(Flag : byte); 
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var BiosTSByte byte absolute $0040:$0017;{ BIOS keyboard status byte 


a 


Regs Registers; { processor registers for interrupt call } 
begin 
BiosTSByte := BiosTSByte or Flag; { mask out the corresponding bit } 
Regs.AH := 1; { function no.: character ready? } 
intr ($16, Regs); { call BIOS keyboard interrupt } 
end; 


{RA RAKAKAAKAKRK KERR KKEK EKER HARKER KEKE KEREEKKEKKEKKKKKKEKEEKKKKKEKKKKEEKS | 
{* CLRFLAG: clears one of the flags in the BIOS keyboard status byte = 
{* Input : the flag to be cleared (see constants) +} 


{* Output : none *} 
{ AHHH IKKE HK KKK KKK KKK KKK EKER EKER KKK KKK KKH AKKEKEKKEKEKKEEE | 


procedure ClrFlag(Flag : byte); 


var BiosTSByte : byte absolute $0040:$0017; { BIOS keyb. status byte } 
Regs : Registers; { processor registers for interrupt call } 
begin 
BiosTSByte := BiosTSByte and ( not Flag ); { mask out bit } 
Regs.AH := 1; { function no.: character ready? } 
intr ($16, Regs); { call BIOS keyboard interrupt } 
end; 


[RRR ARK IRR IKKE KERR HK IKI KKH KK IKK KKK KEKE KKK KKK KKK KKK KEKE KEKRKEKEKKEEKKEEE | 


ae MAIN PROGRAM “et 


{RRR K IRE IKIK KKK IKKE KKK KEK KKK KKEK HERE KEKRKEKRE KEK } 


var counter : integer; 


begin 
writeln('LEDP - (c) 1988 by Michael Tischer'); 
writeln(#13,#10, ‘Watch the LEDs on your keyboard!'); 
for counter:=1 to 10 do { run through the loop 10 times } 
begin 
SetFlag( CAPL); { turn on CAPS } 
Delay( 100 }); { wait 100 milliseconds } 
ClrFlag( CAPL ); { turn CAPS off again } 
SetFlag( NUML); { turn on NUM } 
Delay( 100 ); { wait 100 milliseconds } 
ClrFlag( NUML ); { turn NUM off again } 
SetFlag( SCRL); { turn SCROLL LOCK off } 
Delay( 100 ); { wait 100 milliseconds } 
ClrFlag( SCRL ); { turn SCROLL LOCK off again } 
end; 
for counter:=1 to 10 do { run through loop 10 times } 
begin 
SetFlag(CAPL or SCRL or NUML); { all three flags on } 
Delay( 200 ); { wait 200 milliseconds } 
ClrFlag(CAPL or SCRL or NUML); { all flags off again } 
Delay( 200 ); { wait 200 milliseconds } 
end; 
end. 
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C listing: LEDC.C 


[RRR HERE KKK ERK IKEKEEKKRIKEKR EEK AERA KEE KEKE EKEAKIKEEEE / 


/* LEDC */ 
/* Sa ssh ih, cass nn So as ss i i ‘li i Sm! Sn a Sin cm i i cm nas Cm tap uy i us ims ui ny ms i ems acim nh sab cm sie saw cs eames ou us nen x/ 
[* Description : Sets the various bits in the BIOS keyboard ai A 
/* flag, causing the LEDs on the AT keyboard to */ 
/* flash. */ 
/* io ss es fas es cs cs en bc es gus im tis suis Sones io se Gay's sews os ics ems ccs Ges cams Cnc cs ms ae cass ms nes emis sess us aes em ces as Sch cs Saosin ss es inn ve wees Sli cs */ 
/* Author : MICHAEL TISCHER */ 
[* developed on : 22.08.1988 */ 
/* last update : 22.08.1988 */ 
/* Ss ca sn ta se ee i si ch a a ee ee Se eee Sees Se */ 
/* (MICROSOFT C) */ 
/* creation : CL /AS LEDC.C */ 
/* call : LEDC */ 
/* oe us ih Ss ces cece’ Geh sub cin Sc a Gn kins sees a Cs Se Sm Sc mk ecb GS as cas cas ses aes cass eas cas its ete Ss i is els aos wos Se See es sees ve scam oc ew a/ 
/* (BORLAND TURBO C) */ 
/* creation : via the command COMPILE / MAKE */ 


[LRA KIKI IKKE KK EEK KEKE KEKE EE KER KEK EKER EK KEKE KKEKKKKKEKKEKKEKKE / 


#include <dos.h> 


#ifndef MK FP /* was MK FP already defined? */ 
#define MK FP(seg, ofs) ((void far *) ((unsigned long) (seg)<<16| (ofs))) 
#fendif 

#define SCRL 16 /* Scroll Lock bit */ 
#define NUML 32 /* Num Lock bit */ 
#define CAPL 64 /* Caps Lock bit */ 
#define INS 128 /* Insert bit */ 
/*-- BIOS KBF creates a pointer to the BIOS keyboard flag ------------ */ 


#define BIOS _KBF ((unsigned far *) MK FP(0x40, 0x17)) 


[RRA KEKE KEKE KEK EKER KKK KEKE KEK KKK KEKKEKKKKKKKK 


* Function :DELAY * 


Description 
Input parameters 
Return value 


is Waits a certain length of time. 
* 

* 

* Info 

* 

* 

* 


the number of milliseconds to wait. 


a 
co 
n 
PA 
Ht 


Since this function uses the BIOS timer for time 
measurement, the accuracy is limited to about 
1/60 of a second. 


RHKKKK ERK KEKE KEK RK KKK EKER ERE KRK KKK KEKE EEK EKER EEK EEK KEKEKEKEKEEEKEKEKKKKE / 


+ + + + & 


void delay( unsigned pause ) 
{ 
long timer; /* stores the timer value to be reached */ 
union REGS inregs, /* stores the processor registers */ 
out regs; /* INREGS before, OUTREGS after the intr call */ 


inregs.h.ah = 0; /* ftn. no.: read timer */ 
int86(Oxla, é&inregs, soutregs); /* call BIOS timer interrupt */ 
/*- calculate the target time value and check to see if this —~——* / 
/*—- value has been reached. ceimeiel A 


timer = outregs.x.dx + ((long) outregs.x.cx << 16) + 
(pause * 18 + ((pause << 1) / 10)) / 1000; 
do /* polling loop */ 
int86(Oxla, &inregs, s&outregs); /* read timer again */ 
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while ((outregs.x.dx + ((long) outregs.x.cx << 16)) <= timer); 
} 


[RII RIK IIIT IKK KKK KI KKK KIA KEK KIRK KEK IKKE EERIE REE KKK 


* Function >: SET FLAG * 
De We a i aa in ei ne is ins es st ins a se i a es ss as en es hn dew es a ss eae ee a es ene se ed es ee i ee owe em ee we ua 
* Description : Sets individual bits or flags in the BIOS * 
* keyboard flag. * 
* Input parameters : FLAG = the bits or flags to be set i 
* Return value : none > 


HII KT I IKI IKI III IKK KIKI IKK KK KIKI KKK KI KEKE KEK ER KKEKE KE KKEKEKK KKK KK KKK / 


void set_flag( unsigned flag ) 
{ 


union REGS regs; /* stores the processor registers */ 


*BIOS KBF |= flag; /* set the specified bits in the keyboard flag */ 


regs.h.ah = 1; /* ftn. no.: character present? */ 
int 86 (0x16, &regs, &regs); /* call BIOS keyboard interrupt */ 
} 
[III IKI I HI ITI IIIT IKK IKI TIKI TI TIKI KI III KIKI KIKI KER IKKE KEK KKKKKE 
* Function > CLR FLAG . 
Whee Sees eke is ie ie aa ee eee ee a asad eae kk 
* Description : Clears individual bits or flags in the BIOS _ 
m keyboard flag. i 
* Input parameters : FLAG = the bits or flags to be cleared * 
* Return value : none = 


HRA KKK KIKI IKK KKK IKK IK KKK KKK KK KKK KKK KIKI K KKK KKK KEKE KKK KKKEKKEKEKEKKKEKKK KKK / 


void clr flag( unsigned flag ) 
{ 


union REGS regs; /* stores the processor registers */ 
*BIOS KBF &= ~flag; /* mask out bits in the BIOS keyb. flag */ 
regs.h.ah = 1; /* ftn. no.: character present? */ 
int86 (0x16, &regs, &regs); /* call BIOS keyboard interrupt */ 


} 


[RIK IRI IKI IKI IKI KIKI KIKI KIKI KIKI IIIA IKK AKIRA KKK KK KKK KKK KKK / 


fe* MAIN PROGRAM ial d 


[RK IKI IKI KKK KKK KKK KIKI KIKI KKK KEKE KEKE KKAKKKKK KKK | 
void main () 


{ 


unsigned i; /* loop counter*/ 


printf("LEDP - (c) 1988 by Michael Tischer\n\n"); 
printf ("Watch the LEDs on your keyboard! \n"); 


for (i=O; i<10; ++i) /* run through the loop 10 times */ 
{ 
set_flag( CAPL ); /* turn CAPS on */ 
delay( 100 ); /* wait 100 milliseconds */ 
clr flag( CAPL ); /* turn CAPS off again */ 
set_flag( NUML); /* turn on NUM */ 
delay( 100 ); /* wait 100 milliseconds */ 
clr flag( NUML ); /* turn NUM off again */ 
set_flag({ SCRL); /* turn on SCROLL LOCK */ 
delay( 100 }; /* wait 100 milliseconds */ 
clr flag( SCRL ); /* turn SCROLL LOCK off again */ 
} 

for (i=0; i1<10; ++i) /* run through the loop 10 times */ 
set_flag(CAPL | SCRL | NUML); /* all three flags on */ 
delay( 200 ); /* wait 200 milliseconds */ 
clr flag(CAPL | SCRL | NUML); /* all flags off again */ 
delay( 200 ); /* wait 200 milliseconds */ 


} 
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Chapter 13 


Expanded Memory 
Specification 


When the IBM PC was being developed in 1980 its capabilities were quite 
advanced for its time. This was also true of the size of its main memory. The 
maximum size of 640K seemed so large at the time that no one could imagine 
what a user would do with so much memory. Thus the first PCs were equipped 
with 64K, then 128K, and later 256K of memory. But today memory requirements 
are much greater and the standard amount of RAM for PCs, and especially ATs, 
has grown to the full 640K. 


As we enter the age of the 80386 microprocessor, with the introduction of graphic 
user interfaces and multitasking operating systems (Windows®, OS/2®), 640K 
will soon no longer be enough to make full use of the capabilities of the PC. But 
we have reached a boundary that cannot be crossed by just adding more memory 
chips to the computer. A normal PC or XT is limited to 640K and an AT to 16 
megabytes. The 16 meg is only available in the protected mode of the 80286 
processor, and is inaccessible to normal DOS applications. 


Adding memory 


To provide a way around this problem, some leading PC firms got together several 
years ago and devised a way to add more memory to PCs, XTs and ATs that could 
also be accessed under DOS. These companies were Lotus (the developers of Lotus 
1-2-3), Intel (manufacturer of PC processors) and Microsoft (developers of MS- 
DOS and OS/2). They developed a standard known as the LIM standard, after the 
first letters of the company names. 


This standard allows up to 8 megabytes to be added to a PC on an expansion card. 
Only 64K of this 8 megabytes is visible in the 1 megabyte address range of the 
8088 processor, in a window called the page frame. Memory installed in this 
manner is called expanded memory, and should not be confused with the extended 
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memory which ranges beyond 1 megabyte on an AT. The whole system is referred 
to as the expanded memory system, or EMS for short. 


1 megabyte 
Main memory EMS memory 


orTwr eae @ fF ee fF eF =F 


area PP PP PP Pe 
seem 


> Pr DP PP Pe 
DO 


aearenrnr arenraaTrs 


Extra video RAM : 


Pare video ant AOOO . 
Le— 16K pages 


0000 


ar 
- 
_>_ Pll wwe DP Pe PS 
r 
-_ 


EMS memory access (LIM standard) using a window 


There is always at least 64K in the 1 megabyte address space of the PC which is 
not used for main memory, BIOS, video RAM, or other system expansions, so the 
EMS developers decided to use this as a window into the EMS memory. Usually 
this window is at segment address DOOOH, but the EMS hardware allows it to be 
changed. 


Since this window is under the 1 megabyte memory limit, it can be accessed with 
normal assembly language instructions, similar to the way the video RAM is 
accessed. Both read and write accesses are possible. We will look at concrete 
examples of these accesses later on in this chapter. 
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Page frame division 


The whole procedure is somewhat refined by the fact that the page frame is further 
divided into 16K pages. This allows the programmer to access four completely 
different, and perhaps widely separated, pages from the EMS memory. 


The registers on the EMS card allow the programmer to set which pages of the 
EMS memory will be visible in the page frame. The address lines on the EMS 
card are programmed so that the EMS pages are mapped into the page frame and 
appear in the 8088's address space. This process is known as bank-switching. 


In addition to the hardware, the EMS also includes a software interface which 
handles programming the EMS registers and other memory management tasks. It 
is called the EMM (Expanded Memory Manager) and gives you a standard interface 
which you can use to access the EMS cards of different manufacturers. This also 
applies for the extended EMS standard (EEMS) developed by AST Research, 
Quadram, and Ashton-Tate, which goes far beyond the LIM standard. 


The EMM 


Similar to the DOS interrupt 21H, which provides a standard interface to the 
operating system functions, the EMM functions can be called through interrupt 
67H. Before a program tries to use EMS memory and the corresponding EMM, it 
should first check to make sure that an EMS is installed. If it does not do this and 
there is no EMM, the results of a call to interrupt 67H are completely 
unpredictable. Maybe it just won't work; maybe the system will crash. 


To prevent this, a program which uses the EMS should first check to make sure it 
exists. To do this we can use the fact that the EMM is bound into the system as a 
normal device driver when the computer is booted. As such, it naturally has a 
driver header which precedes it in memory and defines its structure for DOS. The 
name of the driver is found at address 10 in the driver header. The LIM standard 
prescribes that this name must be EMMXXXX0. The example programs at the end 
of this chapter test for this name by first determining the segment address of the 
interrupt handler for interrupt 67H. If the EMM is installed, the segment address 
points to the segment into which the EMMXXXXO device driver was loaded. 
Since the driver header is at offset address 0 relative to the start of this segment, we 
just compare the memory locations starting at 10 with the nnme EMMXXXXO to 
see if the EMS memory and the corresponding EMM are installed. 


Once this is verified, access to this memory requires just three steps: 


1.) Just as conventional memory must be allocated with a DOS function, a 
program must first allocate a certain number of EMS pages for itself from 
the EMM. The number of pages to be allocated depends on both the 
memory requirements of the program and how much EMS memory is 
available. 
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2.) If the desired number of pages were successfully allocated, the specified 
pages must first be loaded into one of the four pages of the page frame so 
that data can be written into them or read from them. This results in a 
mapping between one of the allocated pages and one of the four physical 
pages within the page frame. 


3.) When the program is ended or it is done using the EMS storage, the 
allocated pages should be released again. If this is not done, the allocated 
pages will still be owned by the program (even after it ends) and cannot 
be given to other programs. 


As with DOS interrupt 21H, the function number of an EMM call must be loaded 
into the AH register before the interrupt call. In contrast to the DOS functions, the 
function number does not correspond directly to the value in the AH register and 
you must add 3FH to the function number. Thus for a call to function 2H you 
would have to load the value 3FH + 2H or 41H into the AH register. After the 
function call this register contains the error status of the function. The value 0 
signals that the function was executed successfully, while values greater than or 
equal to 80H indicate an error. 


About errors 


Limits 
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You can get the error codes from the error descriptions in the Appendices, but you 
should be aware of one particular error. If the value 84H is in the AH register after 
a call to EMM interrupt 67H, it means that an invalid function number was passed 
in the AH register. 


The following functions are required for a transient program to access the EMS 
memory: 


Function 


3 
Q1H |Get EMM status) 
02H |____Get_segment address of the page frame 
03H 
04H |__ Allocate EMS pages 9 
OSH 
To guarantee proper operation of the EMS hardware and the EMM, you should 
check the EMM status before allocating EMS memory. This is done with function 
01H, which requires no parameters beside the function number in the AH register. 


If it returns the value 0 in the AH register, then everything is OK and you can start 
working with the EMS memory. 


to EMS allocation 


Naturally the number of allocatable EMS pages is limited by the number of free 
pages. Thus you should ensure that the memory requirements of the program do 
not exceed the available memory. Here we can use function 03H, which returns the 
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number of free EMS pages. This function requires no parameters beside the 
function number and returns the number of unallocated pages in the BX register. It 
also returns the total number of installed EMS pages in the DX register. 


If enough EMS memory exists for our program, or if the memory requirements are 
adapted to the available memory, we can then allocate the memory. Function 04H 
must be passed the number of pages to be allocated in the BX register. If the 
requested number of pages were successfully allocated (AH register contains 0 after 
the function call), the caller will find a handle to the allocated pages in the BX 
register. This handle must be used to access the allocated pages and identifies the 
caller to the EMM. This handle must be saved by the caller and losing it means 
not only that the allocated pages cannot be accessed, they can also no longer be 
released. This function can be called multiple times by a program to allocate 
multiple logical page blocks. 


Once we have the page handle we can start accessing the pages. The handle is 
passed to the appropriate functions in the DX register. This also applies to 
function OSH, which maps a logical page to one of the four physical pages of the 
page frame. The number of the logical page is passed in the BX register and the 
physical page number in the AL register. Note that both specifications start at 
zero. If you have allocated 15 pages, then the numbers of the logical pages run 
from zero to 14. 


Once the appropriate page is in the page frame, it can be accessed just like normal 
memory. The offset address of the start-of-page is calculated from the physical page 
number, but the corresponding segment address must be determined with an EMM 
function. Since this address does not change while working with the EMS 
memory, you can read it once at the beginning of the program and then save it ina 
variable. Function 02H returns the segment address of the page frame in the BX 
register. 


When you are done using the EMS, be sure to return the allocated pages to the 
EMM. All you have to do is pass the page handle to function 06H. 


In addition to these six functions, which a normal program can use to access EMS 
memory, there are six more functions which can be useful under certain 
circumstances. These are the following: 


09H 
OCH 
ODH 


JO9H_ | Reset_saved mapping 
jocH | __Get_ number of EMM handles 
jopH_ | Get_the number of pages allocated to a handle 
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Version numbers 


Reading the EMM version number is of interest because the LIM standard has 
changed somewhat since it was introduced. Some functions are no longer supported 
and new functions have been added. The functions presented here are from Version 
3.2, which has now been superseded by version 4.0. Version 3.2 represents a good 
compromise not only because is it very widely used, but because it is also 
completely compatible with Version 4.0. If you don't want to support earlier or 
later EMS versions in your program, you should check the version number at the 
start of the program. The version number will be returned in the AL register after a 
call to function 07H. It is encoded as a BCD number. 


Functions 08H and 09H are important for TSR programs which want to use the 
EMS memory for their own purposes. When a TSR program interrupts a transient 
program and places itself in the foreground, it must take into account the fact that 
the interrupted program may have been using EMS memory and had created a 
certain mapping. Since this mapping must not be changed when returning to the 
interrupted program, it must be saved when the TSR is activated and then restored 
when the TSR exits. Function 08H saves the current EMM mapping and function 
O9H resets the saved status. Both functions must be passed the handle of the 
function. In this case it is the handle of the TSR program, not the handle of the 
interrupted program. 


The last three functions are only important for the memory manager and will not 
be discussed here. More information can be found in the appendix in the EMM 
function descriptions. 


Demonstration programs 
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The following pages contain two programs, one written in Pascal and one in C, 
which illustrate how to use EMS memory. There is no assembly language 
program since, in principle, calls to the EMM functions involve just loading 
variables and constants into registers and calling the EMM interrupt 67H. Using 
the information in the Appendices, it should be easy to write an assembly 
language program which uses the EMS. There is no BASIC program because 
EMS memory is intended to be used with complex and memory-intensive 
applications for which BASIC (or at least GW-BASIC) is not suited. 


The two programs are almost identical, so we will limit ourselves to a discussion 
of the basic program structure. The programs offer a number of functions and 
procedures which can be used to access the various EMM functions. Both 
programs also contain a function called EMS_INST (or EmsInst) which determines 
if an EMM is installed. In Pascal we have a problem because a pointer has to be 
loaded with an address which consists of separate segment and offset addresses. 
Since this is not possible in Pascal, there is an INLINE procedure called MK_FP 
which (like the C macro of the same name) combines a segment and an offset 
address into a (FAR) pointer. The fact that this is a FAR pointer is important 
because the page frame is not in the program's data segment and thus cannot be 
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addressed via the DS register. This is not a problem in Turbo Pascal because the 
code is generated to work with FAR data pointers. In C we have to make sure that 
the program is compiled in a memory model which uses FAR pointers for data. 
This occurs in compact, large, and huge models. 


The main program firsts tests to see if EMM is present and then uses various 
functions to obtain status information about the EMS memory, which it displays 
on the screen. Then a page is allocated and mapped to the first page (page 0) of the 
page frame. The current contents of the video RAM are copied into this page and 
the video RAM is then erased. 


After the copy procedure, a message is displayed for the user and the program waits 
for a key to be pressed. Then it copies the old screen contents back to video RAM 
from page 0 of the page frame and the program ends. 


This program shows that the contents of a page in the page frame can be treated 
just like ordinary data. After you have created a pointer to the corresponding page 
you can manipulate the data on this page, including complex objects like 
Structures and arrays, just like any other data. It is important to make sure that 
your objects fit on one page or that you do not forget to change pages or load a 
new page into the page frame to access larger objects. 


C listing: EMMC.C 


[RRR IKI KR IKK III IIIT III II HII IK IKI ISH IIH IIA IIIA ITH ITA KICK IKK IKK AIK AK / 


/* EMMC */ 
/* i a a es ss csi cer em ess os sais ua as Sas Seco ars a cs aT im sites ng wee ces ead es Soc a oes Ss ees es ss an ee isin ce */ 
7 Description : a collection of functions for using EMS */ 
;* storage (expanded memory). ay 
/* ym ci ess Ge ee a si es “a st acon So ec iss Cas a ens cw ce Sc no tas ea es ca Mee cc se ee ee Os Se eee a ee ee ee ee */ 
;* Author : MICHAEL TISCHER */ 
/* developed on : 08/30/1988 */ 
ss last update : 08/30/1988 */ 
/* te a a cs i cn ss ms Sn ee nes ee Seems dns anv vw sw ets ae Ss Ska ee nce cc Ss ee cs ce x/ 
/* (MICROSOFT C) a A 
;* creation : CL /AC EMMC.C my: 
{> call : EMMC ay 
/* 0 > me a SD HN SS aD ED SEED ED ED SD Gam ate on UD aS ND wets Gs Sdn NP OED GERD ge ED En LD OULD SEED GED AD SAND SARS ORD EES iy SEP WHND GENP ED GINS SN GEN SOU GED SE GES nD DD ED ‘OE WED aD Se CxtD Ch cad SD SED caND Se caND clus MED */ 
| es (BORLAND TURBO C) */ 
f* creation : via the RUN command in the menu line ay 
[= (no project file) */ 
is Info : Note that the Compact memory model must be */ 
/* selected via the compiler model menu option. Ly 


[RRR IKK IRE KKK KKKIIKKIKKIKKKKI KR IKT KKK IKK IKKE KIK IKE / 


#include <dos.h> 
#include <stdlib.h> 
#include <string.h> 


typedef unsigned char BYTE; /* build ourselves a byte */ 
typedef unsigned int WORD; 
typedef BYTE BOOL; /* like BOOLEAN in Pascal */ 
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/*-- MK FP creates a FAR pointer out of segment and offset addresses -*/ 


#ifndef MK _FP /* is MK FP defined yet? */ 
#define MK FP(seg, ofs) ((void far *) ((unsigned long) (seg) <<16| (ofs))) 
#fendif 


/*-~ PAGE ADR returns a pointer to the physical page X within the ----*/ 
/*-- page frame of the EMS memory. wnat / 


#define PAGE _ADR(x) ((void *) MK _FP(ems frame _seg() + ((x) << 10), 0)) 


[/t== Constants ummm ess sso sess see Sees Sse sss sess est / 
#define TRUE 1 /* constants for working with BOOL */ 
#define FALSE 0 

#define EMS INT 0x67 /* interrupt number for access to the EMM */ 
#define EMS ERR -1 /* returned on error */ 
BYTE emm_ec; /* the EMM error codes are placed here */ 


[RRR KEKE KK KEK IKKE KEK EEK KRHA KEKE AEKKKEKKAKKEKKKKK KKK 


* Function > EMS INST « 
tk ——— “am ins Sine Sn an ei Gee’ vs cs Sa ris lo» sss di mse ‘Stns tn ‘Gh ng ni abs etna ts a a ae ae we ee ce ee ee ee ak 
* Description : Determines if EMS memory and the associated = 
is EMS driver (EMM) are installed. * 
* Input parameters : none = 3 
* Return value : TRUE, if EMS memory installed, else FALSE - 


RAKE IKKE EEK KEKEKEK KKK KEKE KEKE KEKKEKKKEKEEKREKKEEKKEKKKE f 


BOOL ems_inst () 
{ 


static char emm_name[{] = { 'E', ‘M', ‘M', 'X', 'X*, *X', *X', ‘'O' }7 

union REGS regs; /* processor registers for interrupt call */ 
struct SREGS sregs; /* segment registers for the interrupt call */ 
BYTE i; /* loop counter */ 
char *emm inspect; /* pointer to the name in the interrupt handler */ 
/*-- construct pointer to name in the header of a switch driver ----*/ 
regs.xX.ax = 0x3567; /* ftn. now: get interrupt vector 0x67 */ 
intdosx(&regs, &regs, &sregs)?; /* call DOS interrupt 0x21 */ 
emm_inspect = (char *) MK FP(sregs.es, 10); /* construct pointer */ 
/*-- search for the name of the EMS driver ------------------------- */ 


for(i=0; i<sizeof emm_name && * (emm inspect++)==emm_name[it+]; ) 


return( i == sizeof emm_name ); /* TRUE if name found */ 
} 


[RRR KIKI K KIRKE KKK KKK KEK KEK KKK KKK KEKE KEKE KEK KEKE EKER KEKE KKK 


* Function > EMS NUM PAGE f 
OT a a a So a in is Sas a os a ss ss aes ses ta es es ed ss es ee ee ak 
* Output Determines the total number of EMS pages * 


* Input parameters none * 


* Return value EMS ERR on error, else the number of EMS pages * 
KHEKKEK KKK EKER KKK KKK IK KK KEKE KEK KEK KIRKE KKK KK KKK KKK EERE KEK KKKEKKEKKE / 


int ems_num_page () 


{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x42; /* ftn. no.: get number of pages */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 
if (emm_ec = regs.h.ah) /* did an error occur? */ 
return (EMS ERR); /* yes, display error */ 
else : /* no error */ 
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return( regs.x.dx ); /* return total number of pages */ 
} 


[RRR RKKERE KEE KIER KKKEK KKK IK KKK KEIR ERE EEK KEK EKKEKKEKKEKKKEKEKE 


* Function > EMS FREE PAGE i 
DE a i ec es a ae ew ik in cee ae Se nh co es ee as ce os ees en Sn hs ee a ae esas case ts te ne tas de sel ee me ln Se in oe we Ss we xk 
* Description : Returns the number of free EMS pages. - 
* Input parameters : none * 
* Return value : EMS ERR on error, else the number of free EMS be 
* pages. : 


HAKKAR IKK HK KKK IKK IKKE KEK KK AERA KARE KK IAK EEK KARE AK KKEKRAREKKKKK KK / 


int ems free page () 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x42; /* ftn. no.: get number of pages */ 
int86(EMS_ INT, &regs, &regs); /* call EMM */ 
if (emm_ec = regs.h.ah) /* did an error occur? */ 

return (EMS_ERR) ; /* yes, display error */ 
else /* no error */ 

return( regs.x.bx ); /* return number of free pages */ 


} 


[RRR IKK KIKI KIKI KKK HII KAKI IKKE AKER KEKE KEKKKKEKKKKKE 


* Function > EMS FRAME _ SEG J 
GOIN i ce asi es Se sw Ses se es eas as dn Ss ens sen Sas cs asm cs sa cn eis snc mans ms star cnins sab ama eem Ls ‘ten cans ces nce Gab‘ ns Ak sc Sus esl ent es eg ut kk 
* Description : Determines the segment address of the EMS page a 
* frames. = 
* Input parameters : none = 
* Return value : EMS ERR on error, else the segment address of sc 
* * 


the page frame. 
HHA KKK ARIK EEK KERIKERI IKI KIKI KIKI KEK IKKE KKK ARK AEKKEKKKEKE / 


WORD ems frame_seg() 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x41; /* ftn. no.: get segment addr page frame */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 
if (emm_ec = regs.h.ah) /* did an error occur? */ 

return (EMS_ERR) ; /* yes, display error */ 
else /* no error */ 

return( regs.x.bx ); /* return segtment address */ 


} 


[RRR KKH RK EEK KEKE KKK IKKE KEKE KEKE EEK EK KIKKEKEKKKKKEKK KEKE 


* Function >EMS ALLOC 7 


* Description : Allocates the specified number of pages and 
* returns a handle for accessing these pages. 
* Input parameters : PAGES : the number of pages to be allocated 
* (each 16 KByte) 

* Return-Wert : EMS ERR on error, else the EMS handle. 


FORT III III III IIIA CIO II III IOI IO TIS IAI AK / 


+ + + & HF 


int ems _alloc(int pages) 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x43; /* ftn. no.: allocate pages */ 
regs.x.bx = pages; /* set number of pages to be allocated */ 
int86(EMS_ INT, &regs, &regs); /* call EMM */ 
if (emm_ec = regs.h.ah) /* did an error occur? */ 
return (EMS_ERR) ; /* yes, display error */ 
else /* no error */ 
return( regs.x.dx ); : /* return EMS handle */ 


} 


[RRA RIKER KER EEK IKK KEK IKKE RE KEKE ERE EKER RKEEK KEKE KER KEKKEKKEEKEEKEREKKKS 
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* Function > EMS MAP z 


* Description : Maps one of the allocated pages specified * 

* by the given handle onto a physical page in the * 
* page frame. * 
* Input parameters : HANDLE: the handle returned by EMS ALLOC * 
* LOGP : the logical page (0 to n-1) = 
* PHYSP : the physical page (0 to 3) * 
5 * 


Return-Wert : FALSE on error, else TRUE. 
KKK AKEREKIKEEREEKREKKIKRKIKR KEKE KKREKAKRE KEKE KRARE KK REEEEEKEEKEKEKEERKEEAKKE / 


BOOL ems map(int handle, int logp, BYTE physp) 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x44; /* ftn. no.: set mapping */ 
regs.h.al = physp; /* set physical page */ 
regs.x.bx = logp; /* set logical page */ 
regs.x.dx = handle; /* set EMS handle */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 


return (!(emm_ec = regs.h.ah)); 


} 


[BRAKE EKKKKKEHKKEKKK KEKE KEKE KEKE EKER ERE KEKE EKER EKKKKEKKKEKKKKKE 


* Function > EMS FREE . 
Dates Se eee A eat ea eo ae eer Wey eA ver RT TS Ee Y EATON Rae ATR SE kh 
* Description : Releases the memory specified by the handle. . 
* Input parameters : HANDLE: the handle returned by EMS ALLOC * 
* Return value : FALSE on error, else TRUE. * 


HARKER KEK KIER EK IEKEIKKEKEKKRIKEKREIKRKEKREKEEKKEKREKEKEKKEKKKEKKKKKKAKRK KKK KE / 


BOOL ems free({int handle) 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x45; /* ftn. no.: release pages */ 
regs.x.dx = handle; /* set EMS handle */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 


return (!(emm_ec = regs.h.ah));/* if AH contains 0, everything's OK */ 
} 


[RRR KKKKKKI KK E KR I KK KEKKEKK KK E KKK I KEKE RE KEK K EKER EK EKER EEK KKKKKKKKKK 


* Function >: EMS VERSION s 
Dee este es as era te ccna is nin Sa ts es ws es kh Ses i cs sc e's a cs in cS is sok Nem en miei ne Ge sn es i a eh cis‘ i eb om sc ak 
* Description : Determines the EMM version number. 3 
* Input parameters : none * 
* Return value : EMS ERR on error, else the EMM version number * 
* Info : In the version number, 10 stands for 1.0, 11 for * 
* x 


1.1, 34 for 3.4, etc. 


WHKKKKKKKEKKEKKKKKE KKK KKK KERIKERI KIA KEIRA IERKRKEKKEKEKEEKKKEK / 


BYTE ems_ version () 


{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x46; /* ftn. no.: get EMM version num. */ 
int86(EMS_ INT, &regs, &Yregs); /* call EMM */ 
if (emm_ec = regs.h.ah) /* did an error occur? */ 
return (EMS ERR) ; /* yes, display error */ 
else /* no error, calculate version number from BCD number */ 


return( (regs.h.al & 15) + (regs.h.al >> 4) * 10); 
} 


[LR IKI IKK IKK KK IKK KK IKK KKK EK KKK KEKE KK KK KEKE KEKE KEKEKHEKEKKEKEEEKKKKKKKKKK 


* Function > EMS SAVE _ MAP * 
GW ne cre ee cn ce oe ere ces ee tn ce wee eae cae ae a cs eae cam ee A wee Sn a TD CD enh eth ND EO ce CED SD AR En GD DAO AD nn DD OED SE CD Si ERD SD MD ORY ED YD GAD tC ED CO ED extn cant kk 
* Description : Saves the mapping between the logical and * 
x physical pages. * 
* Input parameters ; HANDLE: the handle returned by EMS ALLO. * 
* Return value : FALSE on error, else TRUE. ‘ 
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HHKKKKKKEK EKER IKKE KEKE KEK EEK KEK RK KKK AEE KARE EKEKEAEEKRAKKEKEKKE / 


BOOL ems save _map(int handle) 
{ 


union REGS regs; /* processor registers for interrupt call */ 
regs.h.ah = 0x47; /* ftn. no.: save mapping */ 
regs.x.dx = handle; /* set EMS handle */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 


return (!(emm_ec = regs.h.ah));/* if AH contains 0, everything's OK */ 
} 


[BI HK IKK KKK KKK KKK KKK KEKE KKK KKKKKEEKKKKKKAKKKAKKK KKK KAKA KKKKK KEKE 


* Function > EMS RESTORE MAP = 
ee ee a CS aE a eC a OE A GR NO SE NE Cc a ee CR I Rp OR ap rs ee NE PT REE ee kk 
* Description : Restores a mapping between logical and physical * 
x pages saved with EMS SAVE MAP. . 
* Input parameters : HANDLE: the handle returned by EMS ALLOC . 
* Return value : FALSE on error, else TRUE. = 


HAKKKKIKKRK KEE KEKE IKK KKK KKK IKEA KKK KARA KIEK KIKI KEKEKKEKKKEKKKEKE / 


BOOL ems_restore map(int handle) 


{ 


union REGS regs; . /* processor registers for interrupt call */ 
regs.h.ah = 0x48; /* ftn. no.: restore mapping */ 
regs.x.dx = handle; /* set EMS handle */ 
int86(EMS INT, &regs, &regs); /* call EMM */ 


return (!(emm_ec = regs.h.ah));/* if AH contains 0, wverything's OK */ 
} 


[RRR EEK KEKE EKKKEAK REAR KKK KEE KEKE KEKREKKREKKEKKKKEE 


* Function > PRINT _ ERR “ 


* Description : Prints an EMS error message on the screen and * 
* ends the program. J 
* Input parameters : none - 
* Return value : none x 
* Info : This function may only be called if an error = 

tr 


occurred on a prior call to the EMM, 
RHEE KIER ERIK IK KEK KKK EK IKKE KEE KIRK KKK AKER EEE KEKE EKEKKAKK | 


void print _err() 
{ 


Static char nid[] = “unidentifiable"; 
static char *err vec[] = 
{ “Error in the EMS driver (EMM destroyed)", /* 0x80 */ 
“Error in the EMS hardware", /* 0x81 */ 
nid, /* 0x82 */ 
"Tllegal EMM handle", /* 0x83 */ 
“EMS function called does not exist", /* 0x84 */ 
“No more EMS handles available", /* 0x85 */ 
“Error while saving or restoring the mapping", /* Ox86 */ 
“More pages requested than physically present", /* 0x87 */ 
“More pages requested than are still free", /* Ox88 */ 
"Zero pages requested", /* 0x89 */ 
“Logical page does not belong to handle", /* Ox8A */ 
“Illegal physical page number", /* Ox8B */ 
“Mapping storage is full", /* Ox8C */ 
“The mapping has already been saved", /* Ox8D */ 


“Restored mapping without saving first" 
}; 


printf ("\nError in access to EMS memory!\n"); 


printf (" --. %S\n", (emm_ec<0x80 || emm_ec>Ox8E) ? 
nid : err_vec[{emm_ec-0x80]); 
exit ( 1 ); /* End program with error code */ 


} 


[ BRK KKK KK RE KEK KEK KKK KKK KEKE KKK KEKE KEK ERK KEK KEKE KEEK EEK KKK KKEKEKKEKKKKKKKK 
* Function :>VR ADR * 
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GIy isc cas ce sen as as Sais eon ics na sya an ass io ces ua aes tn esi tn es ss tes wet ea sedan sad wis ws i i Wai oi ase iw ws Sess mee ie er i cess a ie is tnt as et ea a “ee intel ai kk 
* Description : Returns a pointer to the video RAM. * 
* Input parameters : none . 
* Return value : VOID pointer to the video RAM. 


RAKE KHIR K EEK EKEEKKIKHKEKKIKEIE KEKE KEREKKKEEREKRKEEKEEEREEERKEREKKEKKAKKKA / 


void *vr_adr() 


{ 


union REGS regs; /* processor registers for interrupt call */ 


regs.h.ah = Ox0f; /* ftn. no.: get video mode */ 
int86 (0x10, &regs, &regs); /* call BIOS video interrupt */ 
return ( MK FP((regs.h.al==7) ? Oxb000 : Oxb800, 0) ); 

} 


[RRR KIRK IIE RIKER IRAE IEE II KIKI ERIK EIT I AKAIKE IERIE AREER AAR / 


fell MAIN PROGRAM Bald 


[RRR EERIE RRIKHK IEEE AIK EIA RK IIA IIK KIKI IKEKRIKIEKEKHEREAKKES / 


void main() 
{ 


int numpage, /* number of EMS pages */ 
handle, /* handle to access to the EMS memory */ 
5 /* loop counter */ 
WORD pageseg ; /* segment address of the page frame */ 
BYTE emmver; /* EMM version number */ 
printf("EMMC - (c} 1988 by MICHAEL TISCHER\n\n") ; 
if ( ems inst() ) /* is EMS memory installed? */ 
{ /* yes */ 
/*-- output information about the EMS memory ---------------------- */ 
if ( (emmver = ems_version()) == EMS ERR) /* get version num. */ 
print _err(); /* error: output error message and end program */ 
else /* no error */ 
printf (“EMM version number : $d.%d\n", 


emmver/10, emmver%10) ; 


if ( (numpage = ems num _page()) == EMS ERR) /* get number of pages */ 
print_err(); /* error: output error message and end program */ 
printf (“Number of EMS pages : $d (%d KByte) \n", 

numpage, numpage << 4); 


if ( (numpage = ems free page()) == EMS ERR) 
print_err(); /* Error: output error message and end program */ 
printt ("3.32 free : %d (%d KByte)\n", 
numpage, numpage << 4); 


if ( (int) (pageseg = ems frame_seg()} == EMS ERR) 
print_err(); /* Error: output error message and end program */ 
printf ("Segment address of the page frame: %X\n“, pageseg); 


printf ("\nNow a page will be allocated from the EMS memory and\n"); 
printf ("the screen contents will be copied from the video RAM\n"); 
printf (“to this page.\n"); 


printf (" -.. press any key\n"); 
getch(); /* wait for a key */ 
/*-- allocate a page and map it to the first logical page in aaa / 
/*-- page frame. Se: 
if ( (handle = ems_alloc(1)) == EMS ERR) 

print err (); /* Error: output error message and end program */ 
if ({ !ems map(handle, 0, 0) ) /* set mapping */ 
print _err(); /* Error: output error message and end program */ 
/*-- copy 4000 bytes from the video RAM to the EMS memory --------- */ 


memcpy (PAGE ADR(0), vr_adr(), 4000); 
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for (i=0; 1i<24; ++1) /* clear the screen */ 
printf ("\n") ; 


printf ("The old screen contents will now be cleared and will be\n"); 
printf (“lost. But since it was stored in the EMS memory, they\n"); 
printf ("can be copied from there back into the video RAM.\n"); 


printf (" -e- press any key\n"); 
getch(); /* wait for a key */ 
/*-- copy the contents of the video RAM from the EMS memory mane t / 
/*-- and release the allocated EMS memory again. anon / 
memcpy (vr_adr(), PAGE ADR(0), 4000); /* copy VRAM back */ 
if ( tems free(handle) ) /* release memory */ 
print _err(); /* Error: output error message and end program */ 


printf ("END") ; 

} 
else /* the EMS driver was not detected */ 
printf ("No EMS memory installed.\n"); 


} 


Pascal listing: EMMP.PAS 


[KARR RRR KERR HR KKK KEK K EK KERR K RR KERR RRR KKK ERE KKK KEKE KEKE KE KEEKKKEKEKKE | 


{* EMMP *} 
{* ih th ct cae ass Cee sc ns us‘ sn em a's nag ‘nn eh rms en san exc ian cS wo, tu aa ci Gc sum sm ah es ea mm Gms i tus St a mn, a St ‘es, *} 
{* Task : Implement certain functions to demonstrate *} 
{* access to EMS memory using EMM. le 
{* is cm ees tty metas inseam ed ci ols uo cau ci mum lcs Goss nscscs uss Sass © cn sass Ses com scam umn me Sis nie tees ems mn ena nt ante Sie mens ae ces en cas Une > es in ams Carl a *} 
{* Author : MICHAEL TISCHER a | 
{* Developed on : 08/30/1988 *} 
{* Last update : 06/21/1989 i 


{FRR AIT KKK IKK HK IK IK IK KK IKK RIK KK HII RIK KIKI KKK IKK KEK KEKE KKK KEKE | 


program EMMP; 


Uses Dos, CRT; { Add DOS and CRT units } 

type ByteBuf = array[0..1000] of byte; { One memory range as bytes } 
CharBuf = array[0..1000] of char; { One memory range as chars } 
BytePtr = “ByteBuf; { Pointer to a byte range } 
CharPtr = “*“CharBuf; { Pointer to a char range } 

const EMS INT = $67; { Interrupt # for access to EMM } 
EMS_ERR =-l]>; { Error if this occurs } 
W_EMS ERR = SFFFF; { Error code in WORD form } 
EmmName : array[0O..7] of char = 'EMMXXXX0'; { Name of EMM } 

var EmmEC, { Allocation of EMM error codes } 
i : byte; { Loop counter } 
Handle, { Handle for access to EMS memory } 
EmmVer : integer; { Version number of EMM } 
NumPage, { Number of EMS pages } 
PageSeg : word; { Segment address of page frame } 
Keypress : char; 


{ FE RRAKHKKEAKEEKEKEKERKE KEKE RKEKKEKEKERKEREKKEKEKREKE RE KEEKEEKKEEKEKEEKEKKKEKKKKE | 


{* MK FP: Creates a byte pointer from the given segment and offset *} 


{* addresses. =} 
{* Input : - Seg = Segment to which the pointer should point *} 
{* - Ofs = Offset addr. to which the pointer should point *} 
{* Output : Entire pointer i 
{* Info : The returned pointer can be recast toward any other *} 
{* pointer. sae 
{ FRR AAHHH HERR HK AK H AK KKK KKK KKK EKKKK KIARA EKRKKEKKEKKEEKKKKEKKKEKEKE } 
{SF+} { This routine is intended for a FAR model, and } 

{ should therefore be treated as one UNIT } 
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function MK _FP( Seg, Ofs : word ) : BytePtr; 


begin 
inline ( $8B / $46 / $08 / { mov ax, [bp+8] (Get segment address) } 
$89 / $46 / SFE / { mov [bp-2),ax (and place in pointer) } 
$8B / $46 / $06 / { mov ax, [bp+6] (Get offset address) } 
$89 / $46 / SFC ); { mov [bp-4],ax (and place in pointer) } 


end; 

{$F-} { Re-enable NEAR routines } 
[HARKER EKER KEKE HERE ER ARK KERRIER EKER KEKE HEE EEKREK KEK EEE EKKHEKEKE | 
{* EmsInst: Determines the existence of EMS and corresponding EMM *} 
{* Input : none *} 
{* Output : TRUE if EMS is available, otherwise FALSE *} 


{ARR RRR RIK IKKE RRR IIE KEKE KERRI KEK ERE ER ERK KEKE KEKE RKEEEK KEKE KE | 


function EmsInst : boolean; 


var Regs : Registers; { Processor register for the interrupt call } 
Name : CharPtr; { Pointer to the EMM names } 
i : integer; { Loop counter } 
begin 
{*-- Move pointer to name in device driver header -----------------~ *} 
Regs.ax := $3567; { Function #: Get interrupt vector $67} 
MsDos( Regs ); { Call DOS interrupt $21 } 
Name := CharPtr(MK FP(Regs.es, 10)); { Move pointer } 
{ §ennn---— Search for EMS driver ---*} 
1 := 0; { Start comparison with first character } 
while ((i<sizeof(EmmName)) and (Name*[{i]=EmmName[i])) do 
Inc( i );3 { Increment loop counter } 
EmsInst := (i = sizeof (EmmName) ); { TRUE if name is found } 
end; 


FOCI ICIS ICI IOIIIG ICICI GIGI ICIS IIIS I IOI II TOOT OIA IIIT AT III AAAS 
{* EmsNumPage: Determines the total number of EMS pages =F 
{* Input : none id 
{* Output : EMS ERR if error occurs, otherwise number of EMS pages *} 


{ RRA KKE RRA KRIK EKER EK KKK KKK KKK KKK KHER K KKK KKK KKK KKK EEK KEE KKKKEKREKEKKKKEE | 


function EmsNumPage : integer; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 
Regs.ah := $42; { Function #: Determine number of pages } 
Intr (EMS INT, Regs); { Call EMM } 
if (Regs.ah <>0 ) then { Error occurred? } 
begin { YES } 
EmmEC := Regs.ah; { Get error code } 
EmsNumPage := EMS ERR; { Display error } 
end 
else { No error } 
EmsNumPage := Regs.dx; { Return total number of pages } 
end; 


{ RRA ARK KRHA KR EI KEKE KKK KKK KKK KR AEKKEKKEKE KEKE KEKE EKEKEKEKEKKKKKH KE | 


{* EmsFreePage: Determines the number of free EMS pages *} 
{* Input : none ~) 
{* Output : EMS ERR if error occurs, otherwise the number of un- *} 
{* used EMS pages *} 


{ RHR K RK KEKE KKK KKK KKK KEK EK KEK KEK KEKE KKK KKK KKK KEE KKK EKRE ERR EK KEKKKKEKEKEEE | 


function EmsFreePage : integer; 


var Regs : Registers; { Processor register for the interrupt call } 


610 


Abacus 13. Expanded Memory Specification 


begin 


Regs.ah := $42; { Function #: Determine no. of pages 


Intr (EMS _ INT, Regs); { Call EMM 
if (Regs.ah <>0 ) then { Error occurred? 
begin { YES 


{ Mark error code 
{ Display error 


EmmEC := Regs.ah; 
EmsFreePage := EMS ERR; 


end 
else { No error } 
EmsFreePage := Regs.bx; { Return number of free pages } 
end; 


LR KRKE KKK KEKE KKK KEKKKEKKKKKKEK KEE MK KKK KKK KKK EK KKKEKEKEKKKKKKKKEKEKKKKKKKY 
‘ . 


{* EmsFrameSeg: Determines the segment address of the page frame *} 
{* Input : none *} 
{* Output : EMS ERR if error occurs, otherwise the segment address *} 
{BARRIER RRR KKK KKK RRR KKK ERK KEKE ERE KEKE KEKE ERKKEKEEEKEEKE | 


function EmsFrameSeg : word; 


var Regs : Registers; { Processor register for the interrupt call } 


begin 


Regs.ah := $41; 
Intr (EMS INT, Regs); 
if (Regs.ah <>0 ) then 
begin 
EmmEC := Regs.ah; 


EmsFrameSeg := W_EMS ERR; 


end 
else 


EmsFrameSeg := Regs.bx; 


{ Function #: Get segment addr. page frame 
{ Call EMM 

{ Error occurred? 
{ YES 

{ Mark error code 
{ Display error 


{ No error 
{ Return segment addr. of page frame 


end; 


{ARR RIK RRR RRR KR RE KR KK KKK IKK ERK EKER RK KEKE KE KKK KKK RK KEKE KKEKKEEEKEKE | 


{* EmsAlloc: Allocates the specified number of pages and returns a *} 


{* handle for access to these pages *} 
{* Input : PAGES: Number of allocated pages i 
{* Output : EMS ERR returns error, otherwise the handle *) 


{ BRAKE KERR REE RRR KKK KKK KKK KKK EKER KEK KIRK EKER KEKE EKKEKEKEKEKKKKKKKKK KKK | 


function EmsAlloc( Pages : integer; 


s 


{ Processor register for the interrupt call} 


integer ) : 


var Regs : Registers; 


begin 
Regs.ah := $43; 
Regs.bx := Pages; 


{ Function #: Alocate pages 
{ Set number of allocated pages 


Intr (EMS INT, Regs); { Call EMM 
1f (Regs.ah <>0 ) then { Error occurred? 
begin { YES 


{ Mark error code 
{ Display error 


EmmEC := Regs.ah; 
EmsAlloc := EMS ERR; 


Reet get yet get et et tet 


end 
else { No error } 
EmsAlloc := Regs.dx; { Return handle } 


end; 


{FARRAR RRR RRR RR RIE IKKE RRR KEK K ERK KEKE KER KERR KEKE RER EKER ERIK KE } 


{* EmsMap : Creates an allocated logical page from a physical page in*} 


L™ the page frame *} 
{* Input : HANDLE: Handle received from EmsAlloc a | 
{* LOGP : Logical page about to be created *} 
{* PHYSP : The physical page in page frame *} 
{* Output : FALSE if error, otherwise TRUE *) 


{RRR RR IKK ER RRR KR ERK RER ER EKER ERK RR KER ERR KERR EERE EKKEEKEEKEKEKKEKE | 


function EmsMap(Handle, LogP : integer; PhysP : byte) : boolean; 


var Regs : Registers; { Processor register for the interrupt call } 


611 


13. Expanded Memory Specification 


612 


begin 
Regs.ah := $44; { Function #: Set mapping } 
Regs.al := PhysP; { Set physical page } 
Regs.bx := LogP; { Set logical page } 
Regs.dx := Handle; { Set EMS handle } 
Intr(EMS_INT, Regs); { Call EMM } 
EmmEC := Regs.ah; { Mark error code } 
EmsMap := (Regs.ah = 0) { TRUE is returned if no error } 

end; 


{RAK RRKRKEKE EKER KERR KKEKEEKE KERR KERR KEKE KEKE KEERKKKEKEKEEKR KEKE RKEEEKEKEKEKKEE } 


{* EmsFree ; Frees memory when given with an allocated handle *) 
{* Input : HANDLE: Handle received by AllocEms *y 
{* Output : FALSE if an error, otherwise TRUE *)} 


{RARER HERE EEK EERE KEKE KEKE KE KKK KEKE EKKKEEKKKEKREKEKEKE } 


function EmsFree (Handle : integer) : boolean; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 
Regs.ah := $45; { Function #: Release page } 
Regs.dx := handle; { Set EMS handle } 
Intr (EMS_ INT, Regs); { Call EMM } 
EmmEC := Regs.ah; { Mark error code } 
EmsFree := (Regs.ah = 0) { TRUE is returned if no error } 
end; 


{ REAR HRRK ERE KEKE KERR ERE EK KEKEREKREKKREKREKEEKEKEKEKREKEKKKKEKEKKKKEKEE | 


{* EmsVersion: Determines the version number of EMM >} 
{* Input : none *} 
{* Output : EMS ERR if error occurs, otherwise the version number *} 
{* (11=1.1, 40=4.0, etc.) mi 


{ MA RAAHAEKAAKKEE KKK RKERK AKER EEK KEE ERE EEKEEKRAKEKR EER EEEKREKEERKAKEEEKEKKREKEE | 


function EmsVersion : integer; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 

Regs.ah := $46; { Function #: Determine EMM version } 
Intr (EMS INT, Regs); { Call EMM } 
if (Regs.ah <>0 ) then { Error occurred? } 
begin { YES } 
EmmEC := Regs.ah; { Mark error code } 
EmsVersion := EMS ERR; { Display error } 

end , 
else { No error, compute version number from BCD number } 


EmsVersion := (Regs.al and 15) + (Regs.al shr 4) * 10; 
end; 


{ RHR AKAKAKHREKEKERKEKEKEKKKKEKKEKKKKKKKKKK KKK HK KEKE HERE EKKEKEEKEKKEKKKKKKHKKHK | 


{* EmsSaveMap: Saves dispay between logical and physical pages of the *} 


{* given handle a 
{* Input : HANDLE: Handle assigned by EmsAlloc a 
{* Output : FALSE if error occurs, otherwise TRUE *} 


{BARAK KK HERRERA KKKEEKKKEKRKKKKEKKEKKR EKER EKKEKKKEKKKKKRKEKKKKKKKKE | 


function EmsSaveMap( Handle : integer ) : boolean; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 
Regs.ah := $47; { Function #: Map save } 
Regs.dx := handle; { Set EMS handle } 
Intr (EMS INT, Regs); { Call EMM } 
EmmEC := Regs.ah; { Mark error code } 
EmsSaveMap := (Regs.ah = 0) { Return TRUE if no error } 
end; 
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{RAR RRR IR RE RHRRR ERIK RR ERK EKER IRI KIKI ERA IKKE EERE EKER KEE ERE EKER | 


{* EmsRestoreMap: Returns display between logical and physical pages, *} 


{* from the page saved by EmsSaveMap =} 
{* Input : HANDLE: Handle assigned by EmsAlloc *} 
{* Output : FALSE if an error occurs, otherwise TRUE *} 


{RA RAK KARR ARK RE ERK KREKREKRERERR EKER ERR ERE EKE ER KEAEKERKKEKRENKE | 


function EmsRestoreMap( Handle : integer ) : boolean; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 
Regs.ah := $48; { Function #: Restore map } 
Regs.dx := handle; { Set EMS handle } 
Intr (EMS INT, Regs); { Call EMM } 
EmmEC := Regs.ah; { Mark error code } 
EmsRestoreMap := (Regs.ah = 0) { TRUE returned if no error } 
end; 


{ FRA HARARE KKK KIRKE KIRK ERIK KKK EK KKK KAKA AKER KKK KEIR ERE KK KHKKAEKAEKEEE | 


{* PrintErr: Displays an error message and ends the program *} 
{* Input : none *} 
{* Output +: none a 
{* Info : This function is called only if an error occurs during a *} 


{* function call within this module x} 


{ RRA RHA KHIR KIKI TIKI IKI KIKI KARIERRE KKK AKA KEKEKEKE | 


procedure PrintErr; 


begin 
writeln('ATTENTION! Error during EMS memory access'); 
write (' ee 
if ((EmmEC<$80) or (EmmEc>S8E) or (EmmEc=$82)) then 
writeln('Unidentifiable error') 
else 
case EmmEC of 


$80 : writeln('EMS driver error (EMM trouble) '); 

$81 : writeln('EMS hardware error'); 

$83 : writeln('Illegal EMM handle‘); 

$84 : writeln('Called EMS function does not exist'); 

$85 : writeln('No more free EMS handles available'); 

$86 : writeln('Error while saving or restoring mapping '‘); 
$87 : writeln('More pages requested than are actually ', 


‘available'); 


$88 : writeln('More pages requested than are free'); 
$89 : writeln('No pages requested'); 
$8A : writeln('Logical page does not belong to handle'); 
$8B : writeln('Illegal physical page number'); 
$8C : writeln('Mapping memory range is full'); 
$8D : writeln('Map save has already been done'); 
$8E : writeln('Mapping must be saved before it can', 
‘be restored'); 
end; 
Halt; { Program end } 


end; 


{ RARER RRR RRR RIK KKK KKK KKK IKK KIRK KK REI KK KIER EKR KEKE KEKE KEE ERE KEKKE | 


{* VrAdr: Returns a pointer to video RAM *} 
{* Input : none *} 
{* Output : Pointer to video RAM = 


{ EAR HRKRAK KK KEKE KAKI KKK KKK KEK KEKK KERR KKK EKKKKEKERKEKKEK KEKE KAEKEKKEKEES | 


function VrAdr : BytePtr; 


var Regs : Registers; { Processor register for the interrupt call } 
begin 
Regs.ah := SOf; { Function #: Determine video mode } 
Intr ($10, Regs); { Call BIOS video interrupt } 
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if (Regs.al = 7) then { Monochrome video card? } 
VrAdr := MK FP ($B000, 0) { YES, video RAM at B000:0000 } 
else { Color, EGA or VGA card } 
VrAdr := MK FP($B800, 0); { Video RAM at B800:0000 } 
end; 


[RRR RRR KERR REE RK KEK ERK RK KEE EEK EEK EKR EEE KEK KEKE KREKKREKREKRERKEKEKRKEKEKKKE | 


{* PageAdr: Returns address of a physical page in page frame *) 
{* Input : PAGE: Physical page number (0-3) *} 
{* Output : Pointer to the physical page *} 


{ ER AKKAKKKKKKEK KKK RRR KKK KERR KHER KEKE KEKR ERK KER EREKREREKREKKKEEKEEKER | 


function PageAdr( Page : integer }) : BytePtr; 


begin 
PageAdr := MK FP( EmsFrameSeg + (Page shl 10), 0 ); 
end; 


{RRR HERE EKE EKER EKER HEKR HEE REREKREEKKKREKEREKEKKKEKKEKKEE | 


{** MAIN PROGRAM ae} 


{RRR K HR KEKE KKK KKK KEKE KEK EEK KKEKKEEKKEKKEKKRERKEKEKEKKKRERKKEKEKEKKEKEKEE | 


begin 
ClrScr; { Clear screen } 
writeln('EMMP —- (c) 1988 by MICHAEL TISCHER', #13#10) ; 
if EmsInst then { Is EMS memory installed? } 
begin { YES } 
{*-- Display EMS memory information ------~------- *} 
EmmVer := EmsVersion; { Determine EMM version number } 
if EmmVer = EMS ERR then { Error occurred? } 
PrintErr; { YES, Display error message and end program } 
writeln('EMM Version number : ',EmmVer div 10, ‘.', 
EmmVer mod 10); 
NumPage := EmsNumPage; { Determine total number of pages } 
if NumPage = EMS ERR then { Error occurred? } 
PrintErr; { YES, Display error message and end program } 
writeln('Number of EMS Pages : ‘, NumPage, ' (', 
NumPage shl 4, ‘ KByte)'); 
NumPage := EmsFreePage; { Determine number of free pages } 
if NumPage = EMS ERR then { Error occurred? } 


PrintErr; { YES, Display error message and end program } 
writeln('... free EMS pages remaining : ', NumPage, ‘ (', 
NumPage shl 4, ‘ KByte) '); 


PageSeg := EmsFrameSeg; { Segment address of page frame } 
if PageSeg = W_EMS ERR then { Error occurred? } 
PrintErr; { YES, Display error message and end program } 


writeln('Segment address of page frame: ', PAgeSeg); 


writeln; 

writeln('Now a page from EMS memory can be allocated, and the'); 
writeln('screen contents can be copied from video RAM into this‘); 
writeln('page.'); 


writeln(' --. Please press a key'); 
Keypress := ReadKey; { Wait for a keypress } 
{*~- Page is allocated, and the data is passed to the first----- *} 
{*-- logical page in the page frame 9000 wetmten en *} 
Handle := EmsAlloc( 1 ); { Allocate one page } 
if Handle = EMS ERR then { Error occurred? } 
PrintErr; { YES, Display error message and end program } 
if not (EmsMap (Handle, 0, 0)) then { Set mapping } 
} 


PrintErr; { Error: Display error message and end program 


{*-- Copy 4000 bytes from video RAM into EMS memory -~-*} 
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Move (VrAdr*, PageAdr(0)*, 4000); 


ClrScr; { Clear screen } 

while KeyPressed do { Read keyboard buffer } 
Keypress := ReadKey; 

writeln('Old screen contents are cleared. However, the data '); 

writeln('from the screen is in EMS, and can be re-copied onto ‘); 


writeln('the screen. ‘)? 
writeln(' ..- Please press a key'); 
Keypress := ReadKey; { Wait for a keypress } 
{*-- Copy contents of video RAM from EMS memory and release -—*} 
{*-- the allocated EMS memorv =e} 
Move (PageAdr (0)*, VrAdr*, 4000); { Copy over video RAM } 
if not (EmsFree(Handle)) then { Release memory } 

PrintErr; { Error: Display error message and end program } 


GotoxY (1, 15); 
writeln('END') 


end 
else { EMS driver not available } 
writeln('ATTENTION! No EMS memory installed.'); 


end. 


615 


Chapter 14 


Mouse Programming 


Mouse 


A few years ago mice were considered luxuries for PC applications. Today most 
PCs have mice connected to them. Part of the mouse's popularity stems from the 
development of new and more powerful video standards such as EGA and VGA. 
These graphic cards helped advance the graphic user interfaces such as GEM® and 
Microsoft Windows®, which are almost unusable without a mouse. 


Applications and operating systems alike benefit from mouse support. Ventura 
Publisher® and Microsoft Works® both make intensive use of the mouse. In 
addition, DOS Version 4.0 accepts mouse as well as keyboard input. 


A software interface acts as the connection between a program and the mouse. 
Microsoft Corporation designed this interface for its own mice, but other mouse 
manufacturers accept this interface as a standard. The interface was made available 
to the industry as a minimum standard to retain compatibility with the Microsoft 
mouse. 


This function interface is usually installed either through a device driver which is 
loaded during system boot, or through a terminate and stay resident (TSR) program 
such as MOUSE.COM, included with the Microsoft mouse package. 


functions 


Mouse functions may be accessed in the same way as DOS and BIOS functions 
(you may wish to review the techniques used for addressing DOS and BIOS 
functions—see Chapters 6 and 7 for more information). The individual functions 
can be called through interrupt 33H. The identification number of the function 
must be passed to the AX register. The other processor registers are used in various 
combinations for passing information to a function. 


A total of 34 different functions can be called in this manner, but most 
applications use only a few of these functions. Before we examine each function, 
let's look at the concepts behind the mouse interface. This will help you to 
understand the way individual functions work. We deliberately concentrated here on 
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text oriented mouse control. Pixel oriented applications should use a graphic 
interface such as Windows or GEM from the start, because they provide friendlier 
functions for mouse input than the programming interface offered in this chapter. 


About mouse buttons 


Unlike the keyboard, which has many keys and keyboard codes for each key, a PC 
mouse usually has two or even three mouse buttons. These mouse buttons permit 
the user to select data in an application program. Another important piece of 
information is the actual position of the mouse’s pointer (cursor) on the screen. 
The word pointer stems from the pointer's usual shape: an arrow or a pointing 
finger. 


The mouse driver software always interprets the pointer's location on the screen 
relative to a virtual graphic screen. This virtual screen's resolution depends on the 
video mode and video card currently in use. Since this virtual graphic display 
screen is also used within the text modes to determine the mouse's position and 
forms the basis for communication with the mouse interface, a conversion occurs 
between the graphic coordinates and the mouse pointer's line/column position. 
Since every column or line corresponds to eight pixels, the graphic coordinates 
must be either divided by eight or left shifted by three places in binary mode, 
which mathematically produces the same result. The processor executes the 
shifting much faster than it can execute the actual division. 


More about the mouse pointer 


618 


The pointer shows the mouse’s relative location on the screen. Its shape can vary 
from application to application, and it can even change appearance within an 
application. Word processors often display the mouse pointer as a block, similar to 
the text cursor. In text mode the application can only determine the starting and 
ending line of the pointer. The pointer's size depends on the current character 
matrix and video mode. The options for creating a software pointer are more 
complex, since two 16-bit values called the screen mask and cursor mask govern 
the pointer’s appearance. 


The mouse driver must determine the appearance of the pointer every time the 
pointer changes position on the screen. The cursor mask and screen mask values 
are linked with the two bytes which describe the character code and the character 
color within video RAM. This linkage occurs in two steps. First the character code 
and the attribute byte are linked with screen mask through a binary AND. The 
result of this connection is then linked with the cursor mask through an exclusive 
OR. The result then appears on the screen. 
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This type of linkage allows a number of options for changing the pointer's 
appearance. Four of the most common pointer options are: 


° Pointer appears as one specific character in one specific color 


° Pointer appears as one specific character, but color changes when the 
pointer overlaps a character (e.g., inverse video) 


° Pointer appears as one specific character, but the character color changes 
when the pointer overlaps a character 


° Pointer appears as one specific character, but character color changes to a 
variant of the character color when the pointer overlaps a character 


The standard measurement unit in the mouse interface is the mickey, named after 
Mickey Mouse® (1 mickey = 1/200"). The mouse hardware measures all distances 
in multiples of mickeys. We will use this as the measurement standard throughout 
the rest of this chapter. 


Function OOH: Reset mouse driver 


A program should call the function OOH before calling any of the mouse functions. 
This resets the mouse driver. It can also determine whether a mouse and mouse 
driver exist, by examining the content of the AX register after the function call. If 
the AX register coritains the value OOOOH after the function call, no mouse driver 
was installed. Even if a mouse is connected, the mouse driver no longer exists. If a 
mouse driver and mouse exist, function 00H returns the value FFFFH in the AX 
register. The BX register contains the number of buttons on the mouse. As 
mentioned above, PC mice usually have two mouse buttons, although some mice 
have three buttons. Since very few applications need or use three buttons, two 
buttons will be all you'll need in most cases. 


Function OOH resets the numerous mouse parameters to their default values. The 
mouse pointer moves to the center of the screen. The cursor mask and screen mask 
are defined in such a manner that the cursor appears as an inverse video rectangle. 
Video page 0 is selected as the default page on which the pointer appears. The 
pointer disappears from the screen immediately. 


Function 01H: Display mouse pointer 


Function 01H displays the pointer on the screen. Load the function number into 
the AX register; no other parameters are needed. Since the mouse driver follows the 
movement of the mouse even when the mouse pointer has been disabled, it may 
not necessarily reappear at the position where it was when it disappeared. 


619 


14. Mouse Programming PC System Programming 


Function 02H: Remove mouse pointer 


Function 02H removes the mouse pointer from the screen. Load the function 
number into the AX register; no other parameters are needed. The calls between 
functions 01H and 02H must be called in proper proportions to be effective. For 
example, calling function 02H twice in succession means that you must also call 
function 01H twice in succession to return the pointer to the screen. 


Functions 01H and 02H aren't used very much. Often, all you'll need to do is call 
function 00H and function 01H at the beginning of a program, and call function 
02H at the end of the program. These functions come into play more frequently if 
the application program writes characters directly into video RAM, bypassing the 
slow DOS and BIOS display routines. Avoid writing characters over the mouse 
pointer, or two things will happen: 


1) The mouse pointer disappears if overwritten by another character. 


2) The mouse driver produces the wrong character on the screen when the 
user moves the mouse pointer. Before the pointer appears at a certain 
position on the screen, it records the character which occupied this 
position until now. This character is restored to the old position as soon 
as the pointer moves to another position on the screen. During a direct 
write access to video RAM, the driver does not record that a new character 
was output at the position of the pointer. Therefore, the old (and 
incorrect) character is displayed on the screen during the movement of the 
pointer. 


You can avoid this potential source of errors by removing the pointer before 
character output, and returning the old character to the screen. The new character 
will be stored when the pointer is restored to the screen. This action should not be 
done for every character output, since it slows the system down and negates the 
advantages of direct access to video RAM. We recommend that you remove the 
pointer once from the screen before extensive output such as construction of a 
screen window. After the operation the pointer can be restored on the screen. 


Even though the DOS and BIOS character output functions write their output 
directly to video RAM, you shouldn't worry about programming the pointer when 
working with these functions The reason is that during installation, the mouse 
driver moved interrupt vector 10H, which handles BIOS and DOS screen output, to 
its own routine. The driver can then display or disable the pointer as needed. 


Function 04H: Move mouse pointer 
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Function 04H allows movement of the pointer to a specific location on the screen, 
without moving the mouse. Pass the function number to the AX register, the new 
horizontal coordinate (column) to the CX register, and the new vertical coordinate 
(line) to the DX register. Please note that these coordinates, like all other 
functions, must be relative to the virtual screen. Text coordinates must be 
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multiplied by eight (or shifted left three binary places) before they can be passed to 
function 04H. The coordinates must be located inside a screen area designated as 
the mouse's range of movement. 


Function 00H sets the complete range of the mouse's movement to the entire 
screen area. Functions 07H and 08H limit this range to a smaller area. 


Function 07H & O8H: Set range of movement 


Function 07H specifies the horizontal range of movement. Pass the function 
number to the AX register, the minimum X-coordinate to the CX register and the 
maximum X-coordinate to the DX register. 


Function 08H specifies the vertical range of movement. Pass the function number 
to the AX register, the minimum Y-coordinate to the CX register and the 
maximum Y-coordinate to the DX register. 


After calling these functions the mouse driver automatically moves the pointer 
within the range, unless it is already within the indicated borders. The user cannot 
move the pointer outside this range. 


Function 10H: Exclusion area 


In addition to the area of movement allotted to the pointer, the mouse driver also 
supplies an exclusion area. This exclusion area is a section of the screen which 
renders the mouse pointer invisible when the user moves the pointer into this 
section. The mouse pointer becomes visible again as soon as the user moves the 
pointer away from the exclusion area. This area is undefined after the call of 
function OOH. It can be defined at any time by calling function 10H, but the 
mouse driver can control only one exclusion area at a time. The coordinates of the 
exclusion area are passed to function 10H in the CX:DX and SI:DI register pairs. 
These register pairs specify the upper left corner and lower right corner 
respectively. CX and SI accept the X-coordinate, DX and DI the Y-coordinate. 


The exclusion area and function 02H play special roles during direct access to video 
RAM. Although function 02H removes the pointer from the screen, this can occur 
in conjunction with function 10H only if the pointer is already within the 
exclusion area, or if the user moves the pointer within the exclusion area. This 
makes function 10H practical for situations involving the creation of a larger 
display area (e.g., a window). This allows the pointer to remain on the screen as 
long as it is not within this exclusion area. 


The exclusion area can be removed by calling function 01H or function OOH. 
Function 01H makes the pointer visible automatically if it is already within the 
exclusion area. 
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Function 1DH: Set display page 


Function 1DH sets the display page on which the pointer appears. This function is 
required only if the program switches a display page other than the current one to 
the foreground through direct video card programming. Pass the number of the 
display page to the BX register. When BIOS interrupt 10H activates a display 
page, this function can be omitted, since the mouse driver will automatically adapt 
to the change. 


Function OFH: Set pointer speed 


Two parameters determine the speed at which the mouse pointer moves on the 
display screen. They specify the relationship between the distance of a pointer 
movement and the pixels traversed in the virtual mouse display screen. Function 
OFH allows the user to set these parameters for horizontal and vertical movement. 
The parameters are passed in the CX and DX registers (horizontal and vertical, 
respectively). These numbers indicate the number of mickeys, which correspond to 
eight pixels in the virtual mouse display screen. These eight pixels correspond to 
one line or column in the text mode display screen. 


The default values after calling function OOH are 8 horizontal mickeys and 16 
vertical mickeys. In text mode the pointer moves one column after the pointer is 
moved 8 mickeys (about .04") horizontally. A jump to the next line occurs only 
after the pointer is moved 16 mickeys (about .08") vertically. 


These settings normally can be set at default values, since they work well with all 
resolutions in text mode. This function allows changes if you want faster or 
slower pointer movement. 


Function OAH: Set pointer shape 


Function OAH determines the appearance of the pointer in text mode. The cursor 
mask and screen mask mentioned above are determining factors of the pointer's 
appearance in text mode. Pass OAH to the AX register and the value determining 
the cursor's shape to the BX register. 


Software-specific pointer 
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If the BX register contains the value 0, the mouse driver selects the pointer as 
specified by the software. The screen mask number must be loaded into the CX 
register, and the cursor mask number must be loaded into the DX register. These 
numbers indicate the addresses from which the mouse driver can access pointer 
shape parameters. 
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Hardware-specific pointer 


If the BX register contains the value 1, the mouse driver selects the pointer as 
specified by the hardware. Starting line of the hardware pointer must be loaded into 
to the CX register, and the ending line must be loaded into the DX register. 


Video mode and pointer size 


Remember that the allowable values for starting line and ending line depends on 
the video mode currently in use: 


° The monochrome display adapter allows values from 0 to 13. 
° The color graphics adapter only allows values from 0 to 7. 
° EGA and VGA cards accept values from 0 to 7. The EGA/VGA BIOS 


automatically adapts the number selected to the size of the character 
matrix currently in use. 


The functions listed up until now set the various parameters which control the 
mouse driver. The mouse driver also supports a group of functions which read the 
mouse’s position as well as the status of the mouse buttons. These functions can 
be divided into two categories for reading external devices such as the mouse, 
keyboard, printer or disk drives. These categories are the polling method and the 
interrupt method. The mouse driver supports both methods. 


Polling method 


The polling method constantly reads a device within a loop. This loop terminates 
only when the desired event occurs. Since the execution of this loop requires the 
full capabilities of the CPU, no time normally remains to perform other tasks. 


Interrupt method 


The interrupt method has an advantage over the polling method, since the interrupt 
system allows the CPU to execute other tasks until the desired event occurs. Once 
this happens, the mouse driver calls an interrupt routine which reacts to the event 
and executes further instructions. 


Function 03H: Get pointer position/button status 


The polling method offers four functions which operate in conjunction with the 
mouse interface. These functions can be accessed through function 03H, which 
return the current pointer position and mouse button status. Function 03H passes 
the horizontal pointer position to the CX register and the vertical pointer position 
to the DX register. Since these coordinates also refer to the virtual mouse screen, 
they must be converted to the text screen's coordinate system by dividing the 
components by eight, or by shifting the bits right by three binary places. 
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The following table shows how the mouse button status is returned to the BX 
register. Only the three lowest bits represent the status of one of the two or three 
mouse buttons. The bit for the corresponding mouse button contains the value 1 
when the user presses that mouse button during the function call. 


| Mouse button status returned in the BX register after calling 
function 03H | 


xX. x « Disregard these bits | 


Function OCH: Set event handler 
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Function OCH sets the address of a mouse event handler (interrupt routine). The 
function number must be passed to the AX register. The segment and offset address 
of the event handler must be passed to the ES:DX register pair. The event mask 
must be passed to the CX register. The individual bits of this flag determine the 
conditions under which the event handler should be called. The following table 
shows the CX register coding: 


543210987654321 0 & Bits 
X X X X X X X X X ___¢ Disregard these bits 
ce ——C“C‘(1 C= Left_mouse button activated _ 


| ZZ 1 = Center mouse button released | 


The mouse driver calls the event handler after executing the function, as soon as at 
least one of the specified events occurs. The call is made using the FAR call, 
rather than the INT instruction. This difference is important to remember when 
developing an event handler, since the handler must be ended with a FAR RET 
instruction rather than an IRET instruction. Similar to an interrupt routine, none 
of the various processor registers can be changed when they are returned to the 
caller. For this reason the registers must be stored on the stack immediately after 
the call, and the register contents must be restored at the end of the routine. 


Information is passed to the event handler from the mouse driver through 
individual processor registers. The information concerning the event can be found 
in the AX register, where each bit has the same significance as in the event mask 
during the call of function OCH (see above table). Individual bits may be set which 
have no meaning for the event handler. For example, if the event handler should 
only be called when the left mouse button is activated (bit 1), bits 0 and 4 may 
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also be set during the event handler call, because the mouse was moved and the 
right mouse button had been released at the same time. 


The event handler can obtain the current button status from the contents of the CX 
register. The coding is identical during the call to the function 03H. Bits 0 to 2 
represent the different mouse buttons. The current pointer position can be found in 
the CX and DX registers, representing the horizontal and vertical positions, 
respectively. The position can only be set after conversion to the text screen's 
coordinate system. 


During the development of an event handler, the DS register should point to the 
data segment of the mouse driver during the handler call, instead of the interrupted 
program. If the event handler accesses its own data segment, it must first load its 
address into the DS register. 


Function 18H: Install alternate event handler 


Function 18H allows the installation of an event handler which reacts to limited- 
range keyboard events as well as mouse events. This function signals an event if 
the <Ctrl>, <Alt> or <Shift> keys are pressed when a mouse button is pressed or 
released. 


This function is almost identical in register assignments as function OCH. The 
event mask in the CX register has been extended by the three events, as shown in 
the following table: 


Event mask coding in CX register during function 18H call 


X X X X X X X X «~ Disregard these bits 


mouse button event 
button event 
button event 


Even during the call of such an alternative event handler, little changes in 
comparison with the event handlers which were installed by calling function OCH. 
Only the content of the AX register must be interpreted a little differently, since its 
construction corresponds to the event mask shown above. 


Up to three alternative event handlers can be installed by calling function 18H. 
During the function OCH call, the event handler indicated replaces the previously 
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installed handler. Three different event handlers can be installed by calling function 
18H three times. This is only valid if the three event handlers are equipped with 
different event masks. If an event mask passes to function 18H which is already 
equipped with a handler, the new handler replaces the existing handler. 


Demonstration programs 
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This chapter lists programs in C and Turbo Pascal which demonstrate mouse 
access functions. These programs show the techniques of developing and installing 
an event handler, which is the most complicated part of mouse reading. Both 
programs include functions or procedures which call various mouse functions. 
These routines require little programming—they load the processor registers with 
the necessary values, then call interrupt 33H. Since the event handler needs the 
most programming, the text here will focus on that subject. 


Installing an event handler in a higher level language program is somewhat 
difficult, since it must meet certain requirements. These requirements are normally 
beyond the control of a programmer in a higher level language. The requirements 
are as follows: 


° The event handler must be a FAR procedure, and must be terminated with 
a FAR RET instruction. 


2 The event handler must store the various processor registers during the 
call and restore them before completion. 


° The event handler must load the segment address of the higher level 
language data segment into the DS register to provide access to global 
variables of the program. 


These requirements can be met in some versions of Turbo Pascal, Turbo C and 
Microsoft C, although some very complex programming would be required. The 
traditional solution (write a routine in assembly language) is easier and faster to 
implement. Therefore, we wrote the event handler itself in assembler, assembled 
the program and linked the resulting object module to the higher level language 


program. 


This assembler routine is named AssmHand. It stores the various processor 
registers on the stack after the call, then calls a C function or Pascal procedure 
named MouEventHandler. The AssmHand routine passes arguments provided by 
the mouse driver to the MouEventHandler routine. These arguments include: 


. The event flag, which describes the event that caused the handler call. 
° The current mouse button status. 
° The current position of the mouse pointer. 
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This information is converted from virtual graphic screen coordinates into text 
screen coordinates (25 lines x 80 columns). 


The stack handles parameter passing. The C version of AssmHand must pass the 
arguments onto the stack in the reverse order of their declaration. After loading the 
DS register and calling the higher level language routine, these arguments must be 
taken from the stack again by incrementing the stack pointer by the memory 
requirements of the arguments (8 bytes). This is only required for the C version of 
the routine. The Turbo Pascal version performs this task on its own. 


After calling this routine, the AssmHand routine returns the processor registers to 
the stack and passes control to the caller using a FAR RET instruction. 


The AssmHand instructions execute very quickly, but the handler itself may require 
more execution time than expected. This introduces the problem of recursion, since 
an event in connection wiui the mouse may recur during the handler execution. 
The AssmHand driver then must be recalled before the previous call terminated. 


To avoid this situation and the complications which can occur, AssmHand 
maintains a variable named active in its code segment. During execution this 
variable contains the value 1. Before setting this variable, the program tests if 
active already contains the value 1. This indicates that the last call was not yet 
completed. If this situation occurs, the handler execution terminates immediately, 
thus avoiding recursion. 


Even if this method avoids recursion problems, remember that it can produce its 
own problems. The suppression of the higher level language handler does not take 
note of the event, because the handler was not called by the mouse driver. 
Although we offer the recursion trap as an option, we recommend that you 
program the higher level language handler as efficiently as possible to avoid using 
processor time. This will keep call suppression to a minimum. 


AssmHand must first be installed through function OCH, using the 
MoulSetEventHandler procedure/function. MouISetEventHandler is called by the 
Moulnit procedure/function, which initializes the mouse module. This should be 
called by any application program as the first procedure/function of this module. 
The number of lines and columns of the display screen must be passed to it as 
arguments, to determine the size of an internal buffer needed for the various 
procedure/functions within the module. 


This buffer allows division of the screen into individual mouse ranges, each 
equipped with its own code, cursor mask and screen mask. These mouse regions 
are very important in mouse access. They permit the definition of objects such as 
sliders, O.K. buttons or menu items. As soon as the user moves the pointer to and 
object and presses a mouse button, the object executes a particular step in the 


program. 
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MouDefRange defines these regions. The registration of these regions occurs 
through the procedure/function MouDefRange, which must receive a pointer to a 
vector or array, and the number of elements stored there. These elements of the 
type RANGE describe a screen area and the cursor or screen mask assigned to the 
pointer as soon as it reaches this area. An area can comprise a single character or 
the total screen. The user can define the array with individual area descriptors. The 
area code depends on the position of the descriptor within the array, and is provided 
automatically by the procedure/function MouDefRange. The first area has the value 
0, the second the value 1, etc. The screen areas not covered by an area descriptor are 
assigned the code NO_RANGE. 


During the creation of this array, especially during the definition of the cursor and 
screenmask in the PtrMask array, the C implementation provides helpful macros 
and constants. The Pascal program has functions and constants available for this 
purpose. The creation of a variable of the type PTRVIEW, stored in the PtrMask 
field within an area descriptor, is handled by the macro or function MouPtrMask. 
The cursor and screen mask for the character must be passed to MouPtrMask to 
define the pointer's appearance on the screen. 


If PtrSameChar is indicated, the pointer appears as the character which it covers. If 
another pointer is desired, the pointer can be defined with PtrDifChar. When the 
call occurs, enter the ASCII code of the desired character for PtrDifChar. 


As a second parameter MouPtrMask gets the pointer's color from the cursor mask 
and screen mask. Many options for color are possible: 


° PtrSameCol ensures that the pointer assumes the color of the character 
currently overlapped by the pointer. 
° PtrSameColB creates a pointer which assumes the color of the character 


currently overlapped. However, bit 7 of the attribute byte is set to 1 so 
that the character either blinks or appears with a high-intensity 


background color. 

° PtrInvCol makes the pointer appear in the inverse color of the character 
currently overlapped by the pointer. 

° PtrDifCol displays the pointer on the screen in the color indicated by the 
code following PtrDifCol. 


In addition to the different mouse areas specified through MouDefRange, a pointer 
can be assigned to the remaining screen, which is the area carrying the code 
NO_RANGE. A program can use MouSetDefaultPtr to obtain the cursor and 
screen mask of the pointer as a parameter of type PTRVIEW. The constants and 
macros or functions described above can be used to create this parameter. 


The MouEventHandler changes the cursor and screen mask for each area. Since it is 
called for every mouse event (including mouse movement), it can determine the 


Abacus 14. Mouse Programming 


mouse area where the pointer is currently located. To make this happen as fast as 
possible, it tests if the mouse area contains the position of the pointer. 


MouEventHandler uses the internal region buffer which was created by Moulnit 
during the call. It reflects exactly the video RAM structure, and contains one byte 
for every screen position. Each byte contains the code of the area to which the 
screen position was assigned. The event handler can use the current position of the 
pointer as an index to this area buffer. A single memory access is enough to 
determine the mouse area in which the pointer is located. The area code found is 
stored in the global variable MouRng, and is used as an index to the array of the 
mouse descriptor from which it determines the cursor and screen mask for this area. 


The higher level language event handler has another assignment which may be 
even more important. It controls the variable MouEvent, in which the current 
mouse events are stored. This task cannot be performed by simply copying the 
mouse events which were passed through AssmHand from the mouse driver. This 
only shows the current event, but no preceding events. If the user presses and holds 
the left mouse button, then presses the right mouse button, this results in two 
event handler calls. This signals each case of an active mouse button. The 
preceding call (the active left mouse button) is no longer recognized by the call, 
since it reports only the current event (the depressed right mouse button). 


The event handler must isolate the various events which are reflected in the 
EvFlags variable, and accept only new events in the MouEvent variable. This 
variable reflects the current status of the mouse buttons, and the pointer's current 
movement or position. MouEvent can handle the most important mouse sensing 
tasks, waiting for the occurrence of a certain event (usually a pressed mouse 
button). 


MouEventWait waits for the occurrence of an event which was specified by the 
bitmask that was passed earlier. This bitmask can be defined through the logical 
OR function with the following constants: 


EV_MOU_MOVE Mouse movement 
EV_LEFT PRESS Left mouse button pressed 
EV_LEFT_REL Left mouse button released 


EV_RIGHT_PRESS Right mouse button pressed 
EV_RIGHT_REL Right mouse button released 


The procedure/function can be instructed to wait for one or more of these events to 
occur. The AND or OR correspond to the logical comparisons of the same names. 
Which events occur can be sensed through the results of a bitmask in which the 
individual bits represent the various events, and through which the constants 
described above can be sensed. 
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Pascal listing: MOUSEP.PAS 


{ FH RHKKKEKKEKKKRKEKKKKKEKKEKKKKEKREKEKEKKKKEEREKKERAREREKEKKREKRKEKEKRKEEKKEEKKEKEEKKE | 


{* MOUSEP.PAS *} 
{* ‘Ss ess is cin es nce esse insu en ems ao ss hv cca cs in ee mes coms SS mh ws chm es my i tcc ms Kinin i ach nm en's em isu es ub inne uss ui nn Sum Geb ccm 0 *} 
{* Task : Demonstrate the different functions available *} 
{* in mouse programming *} 
{* Gs cs a ln sas as cs lc wee as hm wes oem Semiotics vic sence ops i lt, a i om es ut >t ecm i emi es menses nls ow ene as te ou mom *} 
{* Author : MICHAEL TISCHER *} 
{* Developed on =: 04/21/1989 *} 
{* Last update : 06/01/1989 +} 


{ RE KKKKKKKEKEKKEKKEKREKKEKERKE EKER ERR EKREKEEK EKER EEK KEKEKEREREKEKERKEEEEEKK | 


uses Dos; { Add DOS unit } 


{$L c:\tp\mousepa } { Link assembler module } 
{ adjust path to your system needs } 
== Declaration of external functions ========s==s=ssssessessssessrs=s=====} 


{SF+} { FAR function } 
procedure AssmHand ; external ; { Assembler event handler } 
{SF-} { FAR functions no longer accessible } 
const 
{-- Event -Code@S ~--- nn nn rn rr ern ern ra } 
EV_MOU_MOVE = A { Mouse movement } 
EV_LEFT PRESS = 2; { Left mouse button pressed } 
EV_LEFT_ REL = 4; { Left mouse button released } 
EV_RIGHT PRESS = ; { Right mouse button pressed } 
EV_RIGHT_ REL = 16; { Right mouse button released } 
EV_MOU_ALL =. 317 { All mouse events } 
LBITS = : { EV_LEFT PRESS or EV_ LEFT REL } 
RBITS = 24; { EV_RIGHT PRESS or EV_RIGHT REL } 
NO_RANGE = 255; { Mouse pointer not in xy range } 
PtrSameChar = $00ff; { Same character } 
PtrSameCol = SOOff; { Same color } 
PtrInvCol = $7777; { Inverse color } 
Pt rSameColB = $807f; { Same color, blinking } 
PtrInvColB = SF777; { Inverse color, blinking } 
EAND = 0; { Event comparisons for MouEventWait } 
EVOR = 1; 
CRLF = #13#10; { CR/LF } 
type FNCTPTR = longint; { Address of a FAR function } 
PTRVIEW = longint; { Mask for mouse pointer } 
RANGE = record { Describes a mouse range } 
xl, { Upper left and lower } 
yl, { right coordinates for the } 
x2, { specified range } 
y2 : byte; 
PtrMask : PTRVIEW; { Mask for mouse pointer } 
end; 
RNGARRAY = array [0..100] of RANGE; 
RNGPTR = “RNGARRAY; 
PTRREC = record { Allows access to any } 
Ofs =: word; { mouse pointer record } 
Seg : word; { existing } 
end; 
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PTRVREC = record { Allows access to } 
ScreenMask : word; { PTRVIEW } 
CursorMask : word; 
end; 
RNGBUF = array [0..10000] of byte; { Range buffer } 
BBPTR = “RNGBUF? { Pointer to a range buffer } 


{== global variables 


en we mae ae Ow ee em re =e a } 


var NumRanges, { Number of ranges } 
TLine, { Number of text lines } 
TCol : byte; { Number of text columns } 
MouAvail : boolean; { TRUE if mouse is available !} 
OldPtr, { Old mouse pointer appearances } 
StdPtr : PTRVIEW; { Mask for standard mouse pointer } 
BufPtr : BBPTR; { Pointer to range recognition buffer } 
ActRngPtr: RNGPTR; { Pointer to current range vector } 
BLen : integer; { Range buffer length in bytes } 
ExitOld : pointer; { Pointer to old exit procedure } 


{-- Variables which are loaded into mouse handler on every call --} 


MouRng, { Current mouse range } 
MouCol, { Mouse column (text screen) } 
MouRow > byte; { Mouse line (text screen) } 
MouEvent : integer; { Event mask } 


{-- Variables which load with any occurrence of expected events -} 


EvRng, { Range in which the mouse can be found } 

EvCol, { Mouse column } 

EvRow : byte; { Mouse line } 
{ BR RHR RHR RRR IK IHRE RIK KAR RIK RIKI KIKI KKIK EIR EEK EK IAKREEEREKAKEKKE | 
{* MouPtrMask: Executes Cursor-Mask and Screen-Mask from a bitmap my 
{* containing character and color *} 
{** as S Sn etn G eplSeiegtommkt pin bi Se mS n  mah:  eim i: iS isme i n  v  es mi  scg n o wta l iipls ecademileas ea c stssdaSv s i i xe} 
{* Input : Chars = Bitmask of character as found in Cursor-Mask *} 
{* and Screen-Mask ©} 
{* Color = Bitmask of character color as found in *} 
{* Cursor-Mask and Screen-Mask *} 
{* Output : Cursor-Mask and Screen-Mask as a value of typ PtrView *} 
{* Info: The constants PtrSameChar, PtrSameCol, PtrSameColB, *} 
{* PtrInvCol, PtrInvColB, and the results of the PtrDifChar *} 
{* and PtrDifCol functions also control character & color *} 


{FRR RKK REE E RE KREKRE RK EK ERK IKKEKKEKKKAKEKKKEK EERE ERE KEKE KEERKEKEKKK E | 


function MouPtrMask( Chars, Color : word ) : PTRVIEW; 
var Mask : PTRVIEW; { For creating Cursor-Mask and Screen-Mask } 


begin 
PTRVREC( Mask ).ScreenMask := ( ( Color and Sff ) shl 8 ) + 
( Chars and Sff ); 
PTRVREC( Mask ).CursorMask := ( Color and $ff00 ) + ( Chars shr 8 ); 
MouPtrMask := Mask; { Return mask to caller } 
end; 


{ FHARARHEKKKERAK HARKER RK IRE IAE KERRIER KEIR IKKE I RIEKRHRER NERA EAEKEAKE | 


{* PtrDifChar: Defines character structure of cursor and screen *} 
{* mask in conjunction with character sade 
{** ee en cee a a ere er en oem eam ae a ce cree came a a em ene 0 EO Hee CD ENE UE ne SONA WO ME St ED ERD HUD HD An SEND DD teh CED ES tn ED GED > RD SUD Ghd UND GED GAD tn SEED OOD nem SEND Oe ae} 
{* Input : ASCII code of the character on which pointer is based *} 
{* Output :; Cursor and screen mask for this cursor a} 
{* Info: Function result should be computed with the help of the *} 
{* MouPtrMask function =} 


{ RRR ERK KEKE KEKE ERK ERK RE REI KKK RIK EK ERK REKRKKREKREREEREKREKEKE | 


function PtrDifChar( Chars : byte ) : word; 
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begin 
PtrDifChar := Chars shl 8; 
end; 


{ RAKHI REE KRHA RIERA EKEREKREREKEKREKEEKEREREKEEKE } 
{* PtrDifCol: Creates the character segment of the cursor and screen *} 


{* mask in conjunction with the mouse pointer color 3 
{** eee ee cee Hah ED SR I SD SS SO ND ED TaD ED NP DD SEND HE ND SASS SD SD EDD aD RS SD SND ES Se WD DAD OS Sah mh ae} 
{* Input : Character color on which the mouse pointer will be based *} 
{* Output <: cursor and screen mask for this color *} 
{* Info: The function's result should be computed with the help *} 
{* of the MouPtrMask function | 


[RRR IK HERE REIKI EE KEKE EEKEKREKEE } 


function PtrDifCol( Color : byte ) : word; 


begin 
PtrDifCol := Color shl 8; 
end; 


{ REA RKKRKEK KEKE KK ERK KEE KKK ERE KER EER KKK KEKE KEKRERKEKERKKERKKEEKKKEKKKEKKEEEKE KE | 


{* MouDefinePtr: Assigns the mouse driver the cursor mask and *y 
L . screen mask, from which the driver can create the *} 
{* mouse pointer *} 
{** cee we ean ee Se SD MIS SND sD SD ION SD SD ED ER SRD A A ERD SDN ESD Cu ED GD DGD ED GE SLY NP SD GOED SS GNED GED MD QUE SD GAD MEN CD SAND GU cn NE I SP MD SN ND cD us ne } 
{* Input : Mask = The cursor and screen mask as a parameter of *} 
{* type PTRVIEW a 
{* Info: ~ The mask parameter should be created with the neip of *} 
{* the MouPtrMask function *} 
{* - The most significant 16 bits represent the screen mask, *} 
eg the least significant 16 bits represent cursor mask *} 


{ARH RRR RRR REIKI RIE ERRERRIKE EKER IRE IER RAR REE RIKER AEE EREER | 


procedure MouDefinePtr( Mask : PTRVIEW ); 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
if OldPtr <> Mask then { Mask change since last call? } 
begin { YES } 
Regs.AX := $000a; { Funct. no. for "Set text pointer type" } 
Regs.BX := 0; { Create software pointer } 
Regs.CX := PTRVREC( Mask )}.ScreenMask; { Low-word is AND mask } 
Regs.DX := PTRVREC( Mask ).CursorMask; { High-word ist XOR mask } 
Intr( $33, Regs); { Call mouse driver } 
OldPtr := Mask; { Reserve new bitmask } 
end; 
end; 


{ BAKA KAKKAK KKK KKK KKK ERE KK ERK KKK K EEK KKKEKKKEKKAKKEKKKKEKKEEEKKEKKEKEKKKK KE } 


{* MouEventHandler: Called by the assembler routine AssmHand as soon *} 


{* as a mouse event occurs = 
{** ens nbs essa ns eu ci cu ls bcc ceca ss cme a a ua ci mi ns Cums min cas cca a dsc cs wae cy A a ct’ Gein cms sion cm bo wus inh us eu io unin Sind ices mises xk} 
{* Input : EvFlags = The event mask =} 
{* ButState = Current mouse button status *)} 
Le X, Y = Current coordinates of the mouse pointer on *} 
{* the text screen a 


{ REAR KHEKK EK KRAEKK KEKE ERK KKK ARK ERK HRKEKKE EEK KEE KEKE KKK KEKE EKEKKKEKEEKKKKEKKKEKEE | 


procedure MouEventHandler( EvFlags, ButState, x, y : integer ); 


var NewRng : byte; { Number of new range } 
begin 
MouEvent := MouEvent and not (1); { Bit O excluded } 
MouEvent := MouEvent or ( EvFlags and 1 ); { Bit 0 copied } 


if ( EvFlags and LBITS ) <> 0 then { Lft button released or pressed? } 
begin { YES } 
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MouEvent := MouEvent and not({ LBITS ); { Remove previous status } 


MouEvent := MouEvent or ( EvFlags and LBITS ); { Add status } 
end; 
if ( EvFlags and RBITS ) <> O then { Rgt button released or pressed?} 
begin { YES } 
MouEvent := MouEvent and not ( RBITS ); { Remove previous status } 
MouEvent := MouEvent or ( EvFlags and RBITS ); { Add status } 
end; 
MouCol := x; { Convert columns to text columns } 
MouRow := y; { Convert lines to text lines } 
{-- Determine range in which the mouse should be found and ----} 


{-- determine whether range has changes since the previous call ----} 
{-- of the handler. If so, the cursor image must be redefined. ----} 


NewRng := BufPtr*[{ MouRow * TCol + MouCol Jj; { Get range } 
if NewRng <> MouRng then { New range? } 
begin { YES } 
if NewRng = NO RANGE then { Outside of a range? } 
MouDefinePtr( StdPtr ) { YES, standard pointer } 
else { NO, range recognized } 

MouDefinePtr( ActRngPtr*[ NewRng }].PtrMask ); 

end; 
MouRng := NewRng; { Reserve range number in global variable } 
end; 


{ARR A KH RHH HKK KER KIK KHIR RARE IKE KER IKKE KAA KK KAEAKKKKKEKEREEEEARKEKEKEKE | 


{* MouIBufFill: Store the code for a mouse range within the *) 
{% modulare range memory *} 
{** ise i ig imi lip. mn cn ma i Sn ni sn ei i sts, em se i iin Sts ms es a a a es nc ec hes mms cs mem ca i ess ni wt Ss bam es ib sms ew Wa cans a cea ae} 
{* Input : xl, yl = Upper left corner of the mouse range *} 
{* x2, yY2 = Lower right corner of the mouse range =) 
{* Code = Range code *) 


{ RRR H RHR K EKER K RAKE KKK ER KKKKKE KEK KEK RIKKEKIKKK AKER KKEKRAKKKEEKEKKKKKEKKEE | 


procedure MoulIBufFill( xl, yl, x2, y2, Code : byte ); 


var Index : integer; { Points to array 
Column, { Loop counter 
Line : byte; 


begin 
for Line:=yl to y2 do { Count individual lines } 
begin 
Index := Line * TCol + xl; { First line index } 
for Column:=xl to x2 do { Go through the columns in this line } 
begin 
BufPtr*[ Index ] := Code; { Save code } 
inc( Index ); { Set index to next array } 
end; 
end; 
end; 


{ ROARK ARR HR RRR RK ERE EKKEREREREREIKERK KEE AKAIKE KEKREKEREEKREKKEKRKKKKEKKE | 


{* MouDefRange: Allows the registration of different screen ranges, *} 


{* which the mouse recognizes as different ranges. *} 
{* The mouse pointer's appearance changes when it *} 
{* senses each range *} 
{** ce eee a cats a cD ets an SE OS ce SEND aD ND SD es AND SUED Ge SEED EES END UD i IND SD ESS NS END SE SW SHE nD SERS GetD SOND SEED GD AED GED KD GED SON GED IUD GH GHEE END GURL ttn SD GA eS HED SERS we} 
{* Input : Number = Number of screen ranges *) 
{* BPtr = Pointer to the array in which the individual *} 
{* ranges are written as a structure of type *} 
{* RANGE =) 
{* Info: ~ The free areas of the screen are assigned the code *} 
{* NO_RANGE *} 
{* - When the mouse pointer enters one of the ranges, -} 
{* the mouse range calls the event handler =} 


{RA RAAKR ERK EREREEREEKKREKEKRKEREERERKEEEKKK EKER ERK KEEREKEREKEREKEKREKRKKKKE | 
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procedure MouDefRange( Number : byte; BPtr : RNGPTR ); 


var ActRng, { Number of the current range } 
Range : byte; { Loop counter } 
begin 
ActRngPtr := BPtr; { Reserve pointer to vector } 
NumRanges := Number; { and number of ranges } 
FillChar( BufPtr*, BLen, NO RANGE ); { All elements=NO RANGE } 
for Range:=0 to Number-1 do { Check out different ranges } 


with BPtr*[ Range ] do 
MouIBufFill( xl, yl, x2, y2, Range ); 


{-- Redefine mouse pointer -----------~-------- nr nnn nnn rn n= } 
ActRng := BufPtr*[ MouRow * TCol + MouCol j; { Get range } 
if ActRng = NO_RANGE then { Outside a range? } 
MouDefinePtr( StdPtr )} { YES, standard pointer } 
else { NO, range recognized } 
MouDefinePtr( BPtr*[ ActRng ].PtrMask ); 
end; 


{ FE RAARRERKEREREK REE RHEE ERE KEKE ERERERKEIKEKK KEKE ERKEKKEKEKREKEREREEEKEE } 


{* MouEventWait: Waits for a specific mouse event ~ 
{** a ate eae cD a a cs anne De IO DD Save I ED Se SDT TD SP YR DD ON SES SS SD SE SS FG DD KEN SAN ITD OND OD nc wk} 
{* Input =: TYP = Type of comparison between different events *} 
{* WAIT EVENT = Bitmask which specifies the awaited event *} 
.{* Output : Bitmask of the occurring event bas 
{* Info: - WAIT EVENT can be used in conjunction with OR for other*} 
,* constants like EV_MOU MOVE, EV_LEFT PRESS etc. *} 
{% ~ Comparison types can be given as AND or OR. If AND is *} 
{* selected, the function returns to the caller if all *} 
{* anticipated events occur. OR returns the function to *} 
{% the caller if at least one of the events occurs. x} 


{EAA K EERE RAE REE KEK KKK RRR KE HK EAA EERE KR ERKEKRAEKEKEREKEEEKEKKE | 


function MouEventWait ( Typ : BYTE; WaitEvent : integer ) : integer; 


var ActEvent : integer; 


Line, 
Column : byte; 
CEnd : boolean; 
begin 
Column := MouCol; { Reserve current mouse position } 


Line := MouRow; 
CEnd := false; 


repeat 

{-- Wait for one of the events to occur --------------------------- } 
if Typ = EAND then { AND comparison? } 
repeat { YES, all events must occur } 
ActEvent := MouEvent; { Get current event } 

until ActEvent = WaitEvent 
else { OR comparison } 
repeat { At least one event must occur } 
ActEvent := MouEvent; { Get current event } 


until ( ActEvent and WaitEvent ) <> 0; 


ActEvent := ActEvent and WaitEvent; { Check event bits only } 
{-- While waiting for mouse movement, the event is accepted =~ } 
{-- nonly if the mouse pointer moves to another line and/or -- } 
{-- column in the text screen - } 


if ( ( (WaitEvent and EV_ MOU MOVE) <> 0) and 
{ Column = MouCol ) and ( Line = MouRow ) ) then 


begin { Mouse moved, but still at the same screen position } 
ActEvent := ActEvent and not ( EV_MOU MOVE ); { Move bit out } 
CEnd := ( ActEvent <> 0); { Still waiting for events? } 
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end 
else { Event occurs 
CEnd := TRUE; 
until CEnd; 


— 


EvCol := MouCol; { Determine current mouse position } 
EvRow := MouRow; { and range in global } 
EvRng := MouRng; { variables } 


MouEventWait := ActEvent; 
end; 


{RRA RHR RH HR HK KK REIKI IIR AKER EKER KEK IKKE EERE ARK KEKEEREEKREKEE | 
{* MoulSetEventHandler: Installs an event handler which is called *} 


{* when a particular mouse event occurs. a] 
{** ec a ce ae ee ce ee wee ee ee ee se Oe cS Oe a ec a cere LD el EP PS DE DE OE CD ED UE EO OHS wry} 
{* Input : EVENT = Bitmask which describes the event, called *} 
t* through an event handler *) 
i FPTR = Pointer to the event handler of type FNCTPTR *} 
{* Info: ~ EVENT can be used through OR comparisons in conjunc- *} 
{* tion with constants like EV MOU MOVE, EV LEFT PRESS etc*} 
{* - The event handler must be a FAR procedure, and change *} 
{* none of the given processor registers *} 


{ RRR KR EKER EKER KEKE KKK EK RRR KKK EKER RHR KEE KKK EKER KKK KEKE EE EEK EKE EH | 


procedure MoulSetEventHandler( Event : integer; FPtr : FNCTPTR ); 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
Regs.AX := $000C; { Funct. no. for “Set Mouse Handler" } 
Regs.CX := event; { Load event mask } 
Regs.DX := PTRREC( FPtr ).Ofs; { Offset address of handler } 
Regs.ES := PTRREC( FPtr )}).Seg; { Segment address of handler } 
Intr( $33, Regs }; { Call mouse driver } 
end; 


{ RHR K RK RK RRR K KKK KKK ERIK KK KIARA RRA KKEK KKK KEK ERK EERE EKEEKEKEE | 


{* MoulIGetX: Returns the text column in which the mouse pointer can *} 


Gai be found *} 
{** sas es i em we Sn em i Si el ce mc se ey Spas ce ens a ses ein eens sams cass cas cnn ins Ses hed an i ty es cn Sl ses es er Sl er Sa cs um i ea i ct mes ss aay} 
{* Output : Mouse column converted to text screen a | 


{RRR R RIKKI RK KKK KKK KKK KEK KHAKI E KKK KAKA EKER EK EREREEE | 


function MouIGetX : byte; 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
Regs.AX := $0003; { Funct. no. for "Get mouse position" } 
Intr( $33, Regs ); { Call mouse driver } 
MoulIGetX := Regs.CX shr 3; { Convert column and return new value } 
end; 


{ BARA IKI KIRK IIHR IK RR IK RRR IIIA IKK RHR IKK IIH AIH IR III KIRA KAI AIEEE IER | 


{* MoulIGetY: Returns the text line in which the mouse pointer can *} 
{* be found *} 
{** Ssh Shi i Se oe i i sea i iS a, a lel mt el bs ee ask ek We i ap ins ha le Sl ci Sa ps a a el! a cilia Ul Soh em, Gg Sep ot ae} 
{* Output : Mouse line converted to text screen ma 


{ BARRA RRR HHH I KK IIE IKI KK AHIR KAA AK AEE EREKKEKK | 


function MouIGetY : byte; 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
Regs.AX := $0003; { Funct. no. for “Get mouse position" } 
Intr( $33, Regs ); { Call mouse driver } 
MoulIGetY := Regs.DX shr 3; { Convert line and return new value } 
end; 
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{ RE ARRAEERK EKER KEK ERE KERREKREREEKEKKKEEKEKEEKREKEKKEKEKREREREKEKKEKKEKKEKEKERERE 


{* MouShowMouse: Show mouse pointer on the screen si | 
{** sc cans mc ee i es secs ess sein sn eos Co tt nih ‘co emp eb sh was et io wi ha sh a ec ase eas Ca en mo ts i es ns aa i wo ec ca en us ts wi in ek} 
{* Info: Calls between MouShowMouse and MouHideMouse must be evenly *} 
{* balanced *} 


{ RE RRRAKRKRHEKE KKK EK EKER EKEKKEKEKKEKKEKREKEKEREEKEKKKE ER KEREKEKREKKKREKKEKEKEE | 


procedure MouShowMouse; 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
Regs.AX := $0001; { Funct. no. for “Show Mouse" } 
Intr( $33, Regs ); { Call mouse driver } 
end; 


{RE RRR RRR KE REE KEKE KERRIER EKR ERE ERE KREREREEKEKEKERE | 


{* MouHideMouse: Hide mouse pointer from the screen *} 
{** oe ce cee a ae oe a ie ee ne otc cee ee ee ee es a ane SO Se ca DS OO ce a ED SO RE HN a SOND HED HE DDS GOED DD SD SEND OED GOED EU cD neces «*} 
{* Info: Calls between MouShowMouse and MouHideMouse must be evenly *} 
{* balanced *} 


{ RE RARRKEREKRRKKREKRKEK EERE KKEKRKERERERKEK KEE EKKEKKEEKEREKEKKKEEREREEKEKEKKEE | 


procedure MouHideMouse; 


var Regs : Registers; { Processor regs for interrupt call } 
begin 
Regs.AX := $0002; { Funct. no. for “Hide Mouse" } 
Intr( $33, Regs); { Call mouse driver } 
end; 


{ RA ARRRRKAAK RARER REE KERER EK IAKERKEEEKEKKREKKKEKKEKKKKEERKEKREEKEREKKE | 


{* MouSetMoveArea: Specify movement range for mouse pointer * 
{** ns mcm ss ii i oie ema mas ami’ nen hens epi cums am te Si cs a sain i aes at aac ens ambos esp Sars cme eee sin eu, ni Scan Aer cess Ca aa um ws adn gs Sm cain ome wey} 
{* Input : xl, yl = Coordinates of range's upper left corner = 
{* x2, y2 = Coordinates of range's lower right corner x} 
{* Infos: - The coordinates indicate the text screen coordinates, *} 
{* and not the virtual graphic screen used by the mouse *} 
i* driver *} 


{ BERR R AHR R KAKA KKE ERE EKER ERE AKER KEKE EKER EEK EKKEEKKKKKKEE | 


procedure MouSetMoveArea({ xl, yl, x2, y2 : byte ); 


var Regs : Registers; { Processor regs for interrupt call } 

begin 
Regs.AX := $0008; { Funct. no. for “Set vertical limits" } 
Regs.CX := integer( yl ) shl 3; { Conversion to virtual } 
Regs.DX := integer( y2 ) shl 3; { mouse screen } 
Intr( $33, Regs ); : { Call mouse driver } 
Regs.AX := $0007; { Funct. no. for “Set horizontal limits" } 
Regs.CX := integer( x1 ) shl 3; { Conversion to virtual } 
Regs.DX := integer( x2 ) shl 3; { mouse screen } 
Intr( $33, Regs ); { Call mouse driver } 

end; 


{FR ARHRRAEH HERE ERRKEEERKEREKEKREKREEEE AREER EKER RE KREERKEEEREEEEEEKKKEEE | 


{* MouSetSpeed: Configures movement speed of mouse pointer *} 
{** oe ea a ee ee re een en ee es ee eee am er cn em ow ete a ES ED EDEN ED OE SE OE OE ON a ED EDO E ED LED EDD ED Ene an eee an eben amenenanan xe} 
{* Input : XSpeed = Speed in X-direction *} 
* YSpeed = Speed in Y-direction *} 
{* Infos ~- Parameters are measured in units of *} 
{* - mickeys (8 per pixel) *} 


{ FR AHRARERKE EKER RRR ERERKEEKE ER EKEREK EEK ER ER EKER KEEEKREREKEEKEEEREEEEKEKEEEE | 


procedure MouSetSpeed( XSpeed, YSpeed : integer ); 


var Regs : Registers; { Processor regs for interrupt call } 
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begin 
Regs.AX := S0O0O0f; { Funct. no. for "Set mickeys to pixel ratio" } 
Regs.CX := XSpeed; 
Regs.DX := YSpeed; 
Intr( $33, Regs); { Call mouse driver } 
end; 


{ RHR K HEHEHE RRR REE HR KEEKKR KER ERE RE KR KKKKRKERIEREKREKERKEKKKKEEKEKKEREKHKEKKREKKKEE | 


{* MouMovePtr: Moves mouse pointer to a specific position on the = 
Gg screen *) 
{** sc sno ms Ss eis cs ss sis sh Ss Se Se i st Sun Sn Ges ce eis its ips Gch Gas ind cs ces. tas es os as cn esd os em ie sn ec as oem enaie en aces enum unanae ebaben anes xe} 
{* Input : COL = New screen column for mouse pointer bait 
{* ROW = New screen line for mouse pointer *) 
{* Info: - The coordinates indicate the text screen, and not the *} 
{* virtual graphic screen used by the mouse driver =} 


{ BERR KKK EKER KEKE KEE E EKER K KERR EKEE ERE KEEKKEKEEEKKEKERKEKREKRKEEEKKE | 


procedure MouMovePtr( Col, Row : byte ); 


var Regs : Registers; { Processor regs for interrupt call } 
NewRng : byte; { Range into which the mouse is moved } 
begin 
Regs.AX := $0004; { Funct. no. for “Set mouse pointer position" } 
MouCol := col; { Store coordinates in } 
MouRow := row; { global variables } 
Regs.CX := integer( col ) shl 3; { Convert coordinates and store } 
Regs.DX := integer( row ) shl 3; { in global variables } 
Intr( $33, Regs ); { Call mouse driver } 
NewRng := BufPtr*[ Row * TCol + Col ]; { Get range } 
if NewRng <> MouRng then { New range? } 
begin { YES } 
if NewRng = NO RANGE then { Outside of a range? } 
MouDefinePtr( StdPtr )} { YES, standard pointer } 
else { NO, range recognized } 
MouDefinePtr( ActRngPtr*[ NewRng ].PtrMask ); 
end; 
MouRng := NewRng; { Place range number in global variable } 
end; 


{RE RRR HARRIE HERR KKK KERRIER KIKI KEKE REI KK IK EAE KEEKKHKKKERKKEEKREKEKEKKE } 


{* MouSetDefaultPtr: Defines default pointer appearance for screen *} 


{* ranges not assigned as special ranges i 
{** (Se ca ees cee a cee eae ene eee ee ens TD an ED ED woe CED Sh a eee NS TD END SEND GD uD SEND an ey GD ES SEND SUA ID GED ND SD ERD COND DD chm END GND Sm cnn GNP GP Sa SEED >in ED SND ner CED SUNG GamD cam eto a} 
{* Input : Standard = Cursor and screen mask for mouse pointer *} 
{* Info: - The parameters should be created with the help of the *} 
{* MouPtrMask function ¥} 


{ RRR RRR RRR RR KIER RHR KERIKERI K RR KAKA RK RAK REE KEKE KEKE EKEKKKKKK EK | 
procedure MouSetDefaultPtr( Standard : PTRVIEW ); 


begin 
StdPtr := Standard; { Reserve bitmask in global variable } 


{-- If the pointer isn't currently in a range, convert to default ---} 


if MouRng = NO RANGE then { No range? } 
MouDefinePtr( Standard ); { NO } 
end; 


{ FERRARA RH ARERR RR EKK ERK ER ERE KERR KR KK EKER RK ERE KEKE KEKE KKEKRKEKERERRKERKKEKEEKE | 


{* MouEnd: End the mouse module functions and procedures *] 
{** See 6s aa is es a i ee es cs Ga ce em en em ne Gms aonb toes ove io cae can a ies dn en ew ne aim ns ne a as ne in ee i ne oe a a ean cen ow as en amen en an anan ananenasam taal | 
{* “Info: ~ This procedure doesn't have to be called direct from the*} 
in application, since the MouInit function defines this *)} 
{* as the exit procedure * 


{FARRER HKHK KER EKK KEK EERKRE EKER IK RE AEKRER ERK EKER EKER ERKEKKKKKEEKERKEKE | 
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{SF+} { must be FAR to allow call as exit procedure } 
procedure MouEnd; 
var Regs : Registers; { Processor regs for interrupt call } 


begin 
MouHideMouse; { Hide mouse from screen } 
Regs.AX := 0; { Reset mouse driver } 
Intr( $33, Regs); { Call mouse driver 


w 


FreeMem( BufPtr, BLen ); { Release allocated memory } 


ExitProc := ExitOld; { Restore old exit procedure 
end; 


— 


{$F-} { No more FAR procedures } 


{ RR RRKKRRKEKRKERKEKERKE REE KEKE KERR EK ERK KERR KEREEKKEKERKEKEKEKKEEKKEEKKEREKEKEKE } 


{* MouInit: Initializes mouse functions and procedures as well as *} 
{* variables bo 


{* Input : Columns = Number of screen columns *)} 
i Lines = Number of screen lines *} 
{* Output : TRUE if a mouse driver is installed, else FALSE *} 
{* Info: - This function must be the first called from an *} 
{* application program, before other procedures and *} 


{* functions can be called *} 
{ RH AAAKKHEKK KKK KEKE KEKE ERE KKKEKEREKRERE KEKE KEKEKEKKEREKKEEEKKEEKEKEKKEEE | 


function MouInit ( Columns, Lines : byte ) : boolean; 


var Regs : Registers; { Processor regs for interrupt call } 

begin 
TLine := Lines; { Store number of lines and } 
TCol :s:= Columns; { columns in global variables } 
ExitOld := ExitProc; { Set address of exit procedure } 
ExitProc := @MouEnd; { Define MouEnd as exit procedure } 
{-- Allocate and fill mouse range ~9------~--<9-~- nn en nnn nn } 
BLen := TLine * TCol; { Number of characters in screen } 
GetMem( BufPtr, BLen }; { Allocate internal range buffer } 


MoulBufFill( 0, 0, TCol-1, TLine-1, NO RANGE ); 


Regs.AX := 0; { Initialize mouse driver } 
Intr( $33, Regs ); { Call mouse driver } 
MoulInit := ( Regs.AX <> 0 ); { Mouse driver installed? } 
MouSetMoveArea( 0, 0, TCol-1, TLine-1 ); { Set move area } 
MouCol s= MoulGetx; { Load current mouse position } 
MouRow := MoulGetyY; { into global variables } 
MouRng := NO_RANGE; { Pointer in no set range } 
MouEvent := EV_ LEFT REL or EV_RIGHT REL; { No mouse button pressed } 
StdPtr := MouPtrMask ( PTRSAMECHAR, PTRINVCOL ); { Std. pointer } 
OldPtr s= PTRVIEW( O ); 


{-- Install assembler event handler “AssmHand" -------~-----~------------ } 
MoulSetEventHandler( EV _MOU_ALL, FNCTPTR(@AssmHand) ); 


end; 
{RH RRRRHRRRK HARKER KEKE AKER RRR RKEKKEREK EKER ERKKKKRERKEEKKEKKK 


. MAIN PROGRAM * 


RRR KKK KK KKK RK EEK KIRKE REE KEE KRRAKKREKREKKKRAKEKREREKEKREREKREREKREKEREKEKE } 


const Ranges : array[(0..4] of RANGE = { The mouse range } 
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( xl: O; yl: O; x2: 793 y2: 0), { Top line } 
(xls Of yle Is x2: Of y2 :23..), { Left column } 
( xl: O; yl: 24; x2: 78; y2: 24 ), { Bottom line } 
( xl: 797; yl: 1; x2: 79; y2: 23), { Right column } 
( x1: 797 yl: 247 x2: 797 y2: 24 ) { Lower right corner } 
); 
var Dummy : integer; { Get result from MouEventWait } 
begin 
{-- Configure mouse pointer for the different mouse ranges ---------- } 


Ranges[ 0 ].PtrMask := MouPtrMask( PtrDifChar ($18), PtriInvCol); 
Ranges[ 1 ].PtrMask := MouPtrMask( PtrDifChar ($1b), PtrInvCol); 
Ranges[{ 2 ].PtrMask := MouPtrMask( PtrDifChar ($19), PtrInvCol); 
Ranges[ 3 ].PtrMask := MouPtrMask( PtrDifChar ($la), PtrInvCol); 
Ranges[ 4 ].PtrMask := MouPtrMask( PtrDifChar ($58), PtrDifCol ($40) ); 
writeln (#13#10, 'MOUSEP - (c) 1989 by MICHAEL TISCHER'#13#10) ; 
if MouInit( 80, 25 ) then { Initialize mouse module } 
begin { OK, there's an installed mouse driver } 
writeln('Move the mouse pointer around the screen. As you move ',CRLF, 
‘it around the edge of the screen, you will see the mouse',CRLF, 
‘pointer change its appearance. The pointer shape changes ',CRLF, 


‘as you move the mouse from edge to edge. ', CRLF, CRLF, 
‘To end this program, move the mouse pointer to the ', CRLF, 
‘lower right corner of the screen, and press both the ‘',CRIF, 
‘left and right mouse buttons at the same time. 7 


MouSetDefaultPtr( MouPtrMask( PtrDifChar( $DB ), PtrDifCol( 3) ) ); 
MouDefRange( 5, @Ranges ); { Range definition } 
MouShowMouse; { Display mouse pointer on the screen } 


{-- Wait until the user presses both the left and right mouse ----- } 
{-- buttons simultaneously while the pointer is in range 4 £4<----- } 


repeat { Read loop } 
Dummy := MouEventWait ( EAND, EV_LEFT PRESS or EV_RIGHT PRESS ); 
until EvRng = 4; 


end 
else { No mouse installed OR no mouse driver installed } 
writeln('Sorry, no mouse driver currently installed.'); 
end. 


Assembler listing: MOUSEPA.ASM 


FRR KERERK RK KERR KKK KEK KK EKER ERE KKK ER KKK KKK KEKE KKK ERK EK EKER KEKE KEKEKKERE » 
= MOUSEPA *; 
7* ‘cong mss bs sams ee camps’ Gas ol tm casts as ‘nl min es eu ha eco us aon Guu an a a ec encc un! Ga was cu el es am Sao sccm ei ce sn en sn cl sl che Gc eas eh see ad eh cas eas a an 'st ea es 'ccie a we 
;* Task : Create mouse called event handler for use with *; 
7% a Turbo Pascal program. x; 
SI at ea sin as ie nl scl iia sr hala si ol oS seh i se bs Sami cs kun is ws Si Soc wi em atu li se ca sh cn ea te a Nie ic ha ig cs eb Sa *e 
gv td 
o* Author : MICHAEL TISCHER * 
se Developed on: 04/24/1989 *; 
3* Last update : 04/24/1989 “> 
7* iin acs ss ccs sce ec is Sain mes ames sms esc eu ti te Som Gm ass cae cs ums exis ism LAK cath WAS tems GaSb ems Gai wid ecb Gee cs in Gnd ess Ms eo ebb eis tn Gc wmun tus esc tm i es ins amnesia. Ke 
oe assembly : MASM /MX MOUSEPA; or x 
ak TASM -—MX MOUSEPA; we 
fae ... add to MOUSEP program code *s 
FERRARA KER EKER EERE EEEKEREREEKERRKREREKREKEEREEKEKKEEREEREKREREEKEEEKKK 0 


DATA segment word public 


DATA’ ends snote--no variables in this program 
CODE segment byte public ;Program segment 
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assume CS:CODE :CS points to the code segment whose 
;contents are unknown to DS, SS & ES 
public AssmHand ;Allows the TP program to read 
sthe address of the assembler handlers 
extrn MouEvent Handler : near ;TP event handler to be called 
active db 0 ;points to whether a call can occur 


7~-- AssmHand : The event handler which first calls the mouse driver, then 
aes calls the TP MouEventHandler procedure 

on Direct call from TP not allowed 

AssmHand proc far 


7-- First save all processor registers on stack --- 


cmp active,0 7Call done yet? 

jne ende 7NO --> Don't exit call 

mov active,1 7No more calls, please 

push ax 

push bx 

push cx 

push dx 

push di 

push si 

push bp 

push es 

push ds 

7-~ Push arguments for TP function call onto stack ------- 
7 Call? 

7-- MouEventHandler (EvFlags, ButStatus, x , y : integer ); 
push ax 7Push event flags onto stack 

push bx 7Push mouse button status onto stack 
mov di,cx ;Move horizontal ordinate onto DI 
mov cl,3 ;Counter for coordinate number 

shr di,cl 7Divide DI (horizontal ord.) by 8 and 
push di zpush onto stack 

shr dx,cl ;Divide DX (vertical ord.) by 8 and 
push dx zpush onto stack 

mov ax,DATA ;Segment address of data segment AX 
mov ds,ax ;Move data from AX to DS register 


call MouEventHandler ;Call TP procedure 


;-- Get reserved registers from stack -----------------~------ 


pop ds 
pop es 


mov active,0 7Re-enable call 
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ende: ret ;Return to mouse driver 


AssmHand endp 


CODE ends 7;End of code segment 
end ;End of program 


C listing: MOUSEC.C 


[RRA / 


{* MOUSEC.C lf 
Jiteeiee ee ee  a oe e  ee e */ 
/* Task : Demonstrates mouse access from the C language */ 
/* re Ske cn es ms See ak a i ene ny ee es ses Sec ins ee ek ne es ewe hee med a a x/ 
/* Author : MICHAEL TISCHER mf 
/* Developed on : 04/20/1989 al f 
/* Last update : 06/14/1989 mf 
/* Ti ne mS iS i ca nS ces os im Se mae er “ees Ss ms es hs cows cits es eS esses Sd ses ee to es eas ees oh me nn a se xf 
/* Microsoft C x} 
/* Creation : CL /AS MOUSEC.C MOUSECA. OBJ */ 
{* Call : MOUSEC ball 
/* Seas es Ser ei ws ps ns Sk in ns es Sid a ees es Set ees ew se oe a ee a a a ee ee ee x/ 
ye Turbo C (integrated system) «7 
7 Creation : Create a project file containing the following:*/ 
/* MOUSEC */ 
* MOUSECA. OBJ alt b 
[* Make sure that memory model is set to small. */ 
/* If you didn't assemble the MOUSECA.ASM file iad 
i using the /MX option in MASM, make sure that */ 
/* Case-Sensitive Link on Linker options is OFF. */ 
;* Disable stack checking before compilation. = / 
/* >>NOTE: One warning will occur (about the a 
/* ButState in the MouEventHandler function). ail 
is The program will run. Do NOT _~ remove */ 
| si the ButState declaration - the AssmHand routine*/ 
/* needs it<< */ 
[* Call : MOUSEC */ 


[RAI IKK KIKI KKK KKK KKK KKK IKKE KKK KIRKE KAKA KKE KKK EKER KKEKKKIAKK | 


finclude <dos.h> 
#include <stdlib.h> 


extern void far AssmHand({ void ); /* External declaration */ 
/* of assembler handler */ 
typedef unsigned char BYTE; /* Create a byte */ 
typedef unsigned long PTRVIEW; /* Mouse pointer mask */ 
typedef struct { /* Describe a mouse range */ 
BYTE xl, /* Upper left coordinates of the */ 
yl, /* specified range */ 
x2, /* Lower right corner of the */ 
y2; /* specified range a/ 
PTRVIEW ptr_mask; /* Mouse pointer mask */ 
} RANGE; 
typedef void (far * MOUHAPTR) ( void ); /* Pointer to event handler */ 
#define TRUE (1 ==1 ) 
#define FALSE (1 == 0 ) 
/*-- Event codeS -------------- rn / 
#define EV_MOU_MOVE 1 /* Move mouse */ 
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#define EV_LEFT PRESS 2 

#define EV_LEFT REL 4 

#define EV_RIGHT PRESS 8 /* Right mouse button pressed */ 
6 
1 


/* Left mouse button pressed */ 
/* Left mouse button released */ 


#define EV_RIGHT REL 1 /* Right mouse button released */ 
#define EV MOU ALL 3 /* all mouse events */ 
#define NO RANGE 255 /* mouse pointer not in range xy */ 
[m= MACKOS waren nn ee rer ere nn= */ 
#define MouGetCol () (ev_col) /* Return mouse position & */ 
#define MouGet Row () (ev_row) /* range the moment the */ 
#define MouGet Range () (ev_rng) /* event occurs */ 
#define MouAvail () ( mavail ) /* Available mouse = TRUE */ 
#define MouGetCurCol () ( moucol ) /* Returns current mouse */ 
#define MouGetCurRow () { mourow ) /* position and current */ 
#define MouGetCurRng () ( mourng ) /* mouse range */ 
#define MoulsLeftPress ()} ( mouevent & EV_LEFT PRESS ) 

#define MoulIsLeftRel () ( mouevent & EV LEFT REL ) 

#define MoulsRightPress () ( mouevent & EV_ RIGHT PRESS ) 

#define MoulIsRightRel () ( mouevent & EV_ RIGHT REL ) 


#define MouSetMoveAreaAll (}) MouSetMoveArea( 0, 0, tcol-1, tline-1 ); 


#define ELVEC(x) ( sizeof (x) / sizeof (x[0]) ) /* No. of elements in X */ 


/*-- Bitmask creation macros defining mouse pointer's appearance. ---*/ 
/*-- Syntax for calling MouPtrMask (sample): -——*/ 
[t= MouPt rMask ( PTRDIFCHAR( ‘x' ), PTRINVCOL ) =e / 
/*-- When the pointer is represented as a lowercase x, the inverse ---*/ 
/*-- character color takes effect. my 4 


#define MouPtrMask( z, f )\ 
( (( (PTRVIEW) f) >> 8 << 24) + ((( PTRVIEW) z} >> 8 << 16) +\ 
(((f) & 255) << 8) + ((z) & 255) ) 


#define PTRSAMECHAR ( OxO00ff ) /* Same cahracter a 
#define PTRDIFCHAR(z) ( (z) << 8 ) /* Other characters ied 
#define PTRSAMECOL ( OxO00ff ) /* Same color df 
#define PTRINVCOL ( 0x7777 ) /* Inverse color */ 
#define PTRSAMECOLB ( Ox807f ) /* Same color (blinking) */ 
#define PTRINVCOLB ( OxF777 ) /* Inverse color (blinking) */ 
#define PTRDIFCOL(f) ( (f) << 8 ) /* Other color */ 
#define PTRDIFCOLB(f) (((f£)}|0x80) << 8) /* Other color (blinking) */ 
#define EAND 0 /* Event comparisons for MouEventWait(} */ 


#define EVOR 1 


#define MOUINT (rin, rout) int86(0x33, érin, &rout) 
#define MOUINTX (rin, rout, sr) int86x(0x33, &é&rin, &rout, &sr) 


/*-- Macros for converting mouse coordinates between virtual mouse */ 
/*-- screen and text screen soeat/ 
#define XTOCOL(x) ( (x) >> 3 } /* Xv 8 */ 
#define YTOROW(y) ( (y) >> 3 ) /* Row v 8 */ 
#define COLTOX(c) ( (c) << 3 ) /* Cx 8 */ 
#define ROWTOY(r) ( (r) << 3 ) /* Row x 8 */ 
BYTE tline, /* No. of text lines */ 

tcol, /* No. of text columns */ 

mavail = FALSE; /* TRUE when mouse is available */ 
/*-~ Mask for standard mouse pointer ---------------------~------------ */ 


PTRVIEW stdptr = MouPtrMask({ PTRSAMECHAR, PTRINVCOL ); 


BYTE * bbuf, /* Ptr to range recognition buffer */ 
num_range = 0; /* No range defined until now */ 
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RANGE * cur range; /* Pointer to current range vector */ 
int blen; /* Length of BBUF in bytes */ 
/*-- Variables which load every time the mouse handler is called -----*/ 
BYTE mourng = NO RANGE, /* Current mouse range */ 
moucol, /* Mouse column (text screen) */ 
mourow; /* Mouse row (text screen) */ 
int mouevent = EV_LEFT REL + EV_RIGHT REL; /* Event mask */ 
/*-- Variables which load every time an event anticipated by the ---*/ 
/*-- mouse handler scccurs anaeall A 
BYTE ev_rng, /* Range in which the mouse can be found */ 
ev_col, /* Mouse column */ 
ev_row; /* Mouse row */ 


[RARER KKK KEKE KEKE K EKER KEK KKK KEKE KEKE EKER KEKKKKRKEKKKEKKKKKKKKKKKKK 


* Function >MouDefinePtr * 
FE Ie ass is ta cea eens eh ee eras extn s'est i na Sn‘ es wid cx ‘cr in i “nes bss‘ fas Saw Vins rons ets Gass emesis aa Ss es sd can as ene is ce “me Se ee sei eas sew ess Ls Sou Sees ars em Maen cr Ses eww ms ak 
* Task : Defines the cursor mask and screen mask which = 
determines the mouse pointer's appearance * 
* Input parameters : MASK = Both bitmasks, made into a 32-bit value * 
7 of type UNSIGNED LONG * 
* Return value : None * 
* Info : Most significant 16 bits of MASK = screen mask * 
*x 


least significant 16 bits of mask = cursor mask * 
KHER KKK KKK KKEKREK KKK KEK KKK HAKKAR KER KKK AK KIER KKK KKK KERR EKER KRKEKKEKKKEEK / 


#pragma check_stack (off) /* No stack checking here */ 


void MouDefinePtr( PTRVIEW mask ) 
{ 


static PTRVIEW oldercursor = (PTRVIEW) 0; /* Last value for MASK */ 
union REGS regs; /* Processor regs for interrupt call */ 
if ( oldercursor != mask ) /* Changes since last call? */ 
{ /* YES */ 
regs.x.ax = 0x000a; /* Funct. no. for “Set text pointer type" */ 
regs.x.bx = 0; /* Create software pointer */ 
regs.X.cX = mask; /* Low word is AND-mask */ 
regs.x.dx = mask >> 16; /* High word is XOR-mask */ 
MOUINT (regs, regs); /* Call mouse driver */ 
oldercursor = mask; /* Note old bitmask */ 


} 


J RIKI KK IK KI KK KKK KKK KKK KK KIKI IRR KEK KKK IK MIKI KIKI KEK EK KEK KEKE 


* Function >MouEventHandler * 
GO We sts swe ss es tes re i cts em i meme ese cai tm ink ec eh ce sci ss in Si iin men is cn “se “em nei‘ a Cen ens rsa Cen sn a nis i eas uae kk 
* Task : Calls AssmHand routine from mouse driver, when * 
* a mouse related event occurs. i 
* Input parameters : EvFlags = Event's event mask * 
= But State = Mouse button status x 
i xX, Y = Current pointer position, converted * 
* into text screen coordinates * 
* Return value : None * 
* Info : - This function ise only operational through a * 
* mouse driver call, and shouldn't be called = 
* from another function. 


KHKKKKKEKK KEKE KEK KEK KKK KEK K EK KKK KEKE EEK KHER KEKE KEKE KKK EKEKEKKEKKKKKKKKKKEK / 


void MouEventHandler( int EvFlags, int ButState, int x, int y ) 


#define LBITS ( EV_LEFT PRESS | EV_LEFT REL ) 
#define RBITS ( EV_RIGHT PRESS | EV RIGHT REL ) 


unsigned newrng; /* New range number */ 
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mouevent &= ~1; /* Clear bit 0 */ 
mouevent |= ( EvFlags & 1 ); /* Copy EvFlags to bit 0 */ 
if ( EvFlags & LBITS ) /* Left mouse button pressed or released? */ 
{ /* YES */ 
mouevent &= ~LBITS; /* Clear previous status */ 
mouevent |= ( EvFlags & LBITS ); /* Add new status */ 


} 


if ( EvFlags & RBITS ) /* Right mouse button pressed or released? */ 


{ /* YES, Clear and set bits */ 
mouevent &= ~RBITS; /* Clear previous status */ 
mouevent |= ( EvFlags & RBITS ); /* Add new status */ 
} 
moucol = x; /* Convert columns into text columns */ 
mourow = y; /* Convert rows into text rows */ 
/*~-- Check range in which mouse is currently located, and compare --*/ 
/*-- to range since last call. If a change occurs, the pointer's ---*/ 
/*-- appearance will have to be changed. aan / 
newrng = * (bbuf + mourow * tcol + moucol); /* Get range */ 
if ( newrng != mourng ) /* New range? */ 


MouDefinePtr ((newrng==NO_ RANGE) ? stdptr : 
(cur_range+newrng) ->ptr_mask) ; 


mourng = newrng; /* Place range number in global variables */ 
} 

#pragma check_stack /* Re-enable stack checking and old */ 
#pragma check_stack /* status a] 
[BERRI EREREKE RE KKK AKER EEK IRE KEKE KEE EEK EKA KKK AKER KKKKEEIKK 
* Function >MoulrIBufFill = 
FOV ae ce a ec ee ae a ee a ee ee re ee ee cee ee es oe ee es ee a nee ee ee en ee cae ee ee ee ee ee nee ce ne ee ca nD eo ce ene ene cn ee een one ak 
* Task : Stores a specific screen range code within x 
* screen memory affecting the module i 
* Input parameters : x1, yl = Upper left corner of the screen * 
* x2, y2 = Lower right corner of the screen * 
* CODE = Range code * 
* Return value : None - 
* Info : This functions should only be called from within * 
r x 


this module. 
HHKKKKKKKKK HAKKAR KEKE KIER KKRAK ERE KEKHAKHAKREKREKRERKKKKKAKE | 


static void MouIBufFill( BYTE x1, BYTE yl, 
BYTE x2, BYTE y2, BYTE code ) 
{ 


register BYTE * lptr; /* Floating pointer to range mem. */ 
BYTE i, 4; . /* Loop counter */ 
lptr = bbuf + yl * tcol + xl; /* Pointer to first line */ 
/*-—- Go through individual lines ----------------------------------+-- */ 
for (j=x2 - x1 + 1 7 yl <= y2; ++yl, lptrt=tcol ) 

memset ( lptr, code, j ); /* Set code */ 


} 


[RRR IKK IIE KIRKE IK KARE IKK IEK IKKE KEKE KAKK KKK 


* Function >MouDefRange bs 
I i a a ei i se sec te ees pens ei ea ese es cn ed ese nc er en wb ne eee ee ee Se en kk 
* Task : Allows the definition of different screen ranges * 
= which configure a different code for the mouse * 
x pointer, depending on the pointer's location. * 
* Input parameters : - NUMBER = Number of screen ranges * 
* - PTR = Pointer to screen description vector * 
* (type RANGE) * 
* Return value : None ig 
* Info > ~ Free screen ranges receive the code NO RANGE. * 
k * 


- When entering the specified screen range, the 
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mouse handler automatically changes the mouse 
pointer's appearance to correspond with that 
range. 

- Since the specified pointer is stored, but the 
specified vector isn't copied to a separate 
buffer, the contencs of the vecros should not 


be changed on the next call of this function. 
RK KIKK HERKEN | 


+ + + + + HF HF 
+> + + + & & 


void MouDefRange( BYTE number, RANGE * ptr ) 
{ 


register BYTE i, /* Loop counter */ 

range; /* Mouse range */ 
cur_ range = ptr; /* Reserve pointer to vector */ 
num range = number; /* and number of ranges */ 


memset ( bbuf, NO RANGE, blen ); 
for (i1=0 ; i<number ; ++tptr ) 
MoulBufFill( ptr->xl, ptr->yl, ptr->x2, ptr->y2, i++); 


/*-~ Redefine mouse pointer ----------- 9-9 enn nen ren */ 


range = *(bbuf + mourow * tcol + moucol); /* Current mouse range */ 
MouDefinePtr( ( range == NO RANGE ) ? stdptr 
: (cur_range+trange)->ptr_ mask ); 


} 


[RRA KEKERR EKER EKER KERR EERE RE KERIKERI KEE HERE EKER EK 


* Function >MouEventWait * 

OI a in a i a ok ow i a a in i en ese no ss ce ca hc see ee a as sea en wn a es wim ae 
Task : Waits for a specific event from the keyboard. 
Input parameters : TYP = Establishes comparison between 


different events. 
WAIT EVENT = Bitmask which specifies wait event. 
Bitmask which describes this or another event. 
~ WAIT _EVENT can be used with other constants 
such as EV_MOU MOVE or EV_LEFT PRESS when used 
in conjunction with EVOR. * 
~ EAND & EVOR are allowable types. EAND has the * 
ability to return to the caller once ALL events* 
have occurred; EVOR returns to the caller when * 


at least one event occurs. * 
KEK KKK KEKE K KEKE KERR ERK EKRKK KEKE KEKE KKEKEKEKEK EKER KKEKKKEKEKKKKKKKK / 


* 

t 

rt 

t 

* Return value 
* Info 
* 

t 

* 

* 

* 

* 


+ + + + & + 


int MouEventWait ( BYTE typ, int wait_event ) 
{ 


int cur_event; /* Current event mask */ 
register BYTE column = moucol, /* Last mouse position */ 
line = mourow; 
BYTE ende = FALSE; /* TRUE if an event occurs */ 
while ( !ende ) /* Repeat until event occurs */ 
{ 
/*-- Wait until one of the events occurs -------~--------~---------- */ 
if ( typ == EAND ) /* EAND: All events must occur */ 


while ( (cur_event = mouevent) != wait event) 


’ 


else /* EVOR: At least one event must occur */ 
while ( ( (cur_event = mouevent) & wait event) == 0) 


tf 


cur event &= wait event; /* Check event bits only */ 
/*-- When moving the mouse, the event is only accepted if the mat / 
/*-- pointer moves to another row or column on the text screen --*/ 


if ({wait_event «& EV_ MOU MOVE) && column==moucol && 1ine==mourow) 
{ /* Mouse moves, but in same screen position */ 
cur_event &= (~EV_MOU MOVE); /* Examine move bit */ 
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ende = (cur_event != 0); /* Are events pending? */ 
} 
else /* Event occurred */ 
ende = TRUE; 


} 


ev_col = moucol; /* Set current mouse position */ 
ev_row = mourow; /* and mouse range; place in */ 
ev_rng = mourng; /* global variables */ 
return( cur_ event ); /* Return event mask */ 


} 


[ REKKKKKEKEKEKEKREEKEEEKKEKEREKEREEEKEEK KERR KERR ERE EEK KREKREKEKEKKEKKEEKEKK 


* Function s:MoulIlSetEventHandler * 
I is cea cece es sess ent se tie eh Us sie oi cs essa cs ih Sv ip ts pa fc eS Wi in a i sl ia a A em es i is eh oh sl a ei a ee bli kk 
* Task : Installs an event handler which handles events * 
* called from the mouse driver. * 
* Input parameters : EVENT = Bitmask which specifies the event which * 
* calls the event handler. = 
* PTR = Pointer to the mouse handler * 
* Return value : None * 
* Info : ~ EVENT can be used in conjunction with the EVOR * 
* comparison on constants such as EV_MOU MOVE, * 
* EV_LEFT PRESS * 


FRIAR IK IKI IK IKKE KEK KKK TKK KEK KEKE KKK IKEA EREAEKEEKKKKKKKK / 


static void MoulISetEventHandler( unsigned event, MOUHAPTR ptr ) 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
struct SREGS sregs; /* Segment register for interrupt call */ 
regs.x.ax = 0x000C; /* Funct. no. for “Set Mouse Handler" */ 
regs.x.cx = event; /* Load event mask */ 
regs.x.dx = FP OFF( ptr ); /* Offset address of handler */ 
sregs.es = FP SEG( ptr ); /* Segment address of handler */ 
MOUINTX( regs, regs, sregs }); /* Call mouse driver */ 


} 


[RARKKKKKKKKEKKEKKEKKEKKKKKERKEEKKEKKEKKKEKEKKEKEKEKHEKEKKKEKKEKKKEKKKKKKKKKKKKKKK 


* Function :MoulrIGet xX = 
GOW ins in ae ns ina sis ism aan as snes Ges ns is secs ccs is seis ss Seo i enh seca ss i cc ines ep wa a i cs sc ees ssn Gave Sere Ms Slee Sees Sus Sw lw anos im) GD ONO co kk 
* Task : Determines text column in which pointer lies. * 
* Input parameters : None * 
* Return value : Mouse pointer column, relative to text screen m 


RHR KKK KERR KEKE IKK KEKE KKK REE KKK RK KKEKEKKEKRKKEEKKEKEKRKKKKE / 


static BYTE MouIGetX( void } 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
regs.x.ax= 0x0003; /* Funct. no. for “Get mouse position" */ 
MOUINT( regs, regs ); /* Call mouse driver */ 
return XTOCOL( regs.x.cx ); /* Convert and return column */ 


} 


[RRR RE KEIR IKKE KKK KKK KEKE KERRI KIRKE EKER EEK KEKKEKKEKKK 


* Function >MoulGetyY : 
POD ce cee ce ae en ee cs ca cee eae en ee ee cee eon an em cre enn en cen were cane cate can nn cam ame en as ce ED ED ED Oe ES A wa St HARD ED SO ED A ND MN NE Dh OD SS Sm ee uD xk 
* Task : Determines text row in which pointer lies. * 
* Input parameters : None * 
* Return value : Mouse pointer row, relative to the text screen * 


KHKEKKKKKKEKKKKEKRKEEKEKKEKKKKKEKK KEKE ERK KEKE KEKE REKKEREREKKEKEEEKEKKEKKKKEKEREKREKE / 


static BYTE MoulIGetY( void ) 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
regs.x.ax= 0x0003; /* Funct. no. for “Get mouse position" */ 
MOUINT (regs, regs); /* Call mouse driver */ 
return YTOROW (regs.x.dx) ; /* Convert and return row */ 


} 
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* Function :MouShowMouse * 
PI acs sen is seit Sei sin pes ta ee oe Veh ise co a ia il oe i wes ta" le ep eka i me mea esi Sec ec seme! Cs ed ce i es esta a ha ns es ai cae Kk 
* Task : Display mouse pointer on the screen. * 
* Input parameters : None * 
* Return value : None * 
x Info : Calls of MouHidemMouse() and MouShowMouse(}) must * 
* «x 


be kept balanced. 


RHA IK IKK IKK IHR RE IIR KEI HAIR IKK IKI IAEA KARRI KKK | 


void MouShowMouse( void ) 
i 


union REGS regs; /* Processor regs for interrupt call */ 
regs.x.ax = 0x0001; /* Funct. no. for “Show Mouse" */ 
MOUINT (regs, regs); /* Call mouse driver */ 


} 


[RRA KKRKEKIEKERK KKK EKER EKA KARE KER IK EKEEKKEE KEKE KEKE KKEKRKEEKRKKKKEE 


* Function >MouHideMouse * 


Task : Hide mouse pointer from screen. 
Input parameters : None 
: None 


Info Calls of MouHidemMouse() and MouShowMouse() must 


be kept balanced. 


HHH RIKKI RK KK IKK IRE RA RIKKI KIRK IIHR IK KIKI KIA IKARIA IKARIA IAHR KK / 


+ + + + 


* 
* 
* Return value 
* 
x 


void MouHideMouse( void ) 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
regs.x.ax = 0x0002; /* Funct. no. for “Hide Mouse" */ 
MOUINT (regs, regs); /* Call mouse driver */ 


} 


[RRR IKI KR KIRK IKI KKK IKKE KE KEKE KKK EKER EEK KER KEKE KEKEKREKREEEKE EERE KEKE 


* Function >MouSetMoveaArea 7 
OW i ae in cs a ns i ss ce a es as toe ‘en ee ee ee en ce wind ne Mei oe ae Ses eee es ns et tas ln Ge ed eb ln aes es ee in Sw ee ee ak 
* Task : Defines a screen range within which the mouse sd 
* pointer may be moved. * 
* Input parameters : xl, yl = Coordinates of upper left corner * 
r x2, y2 = Coordinates of lower right corner = 
* Return value : None - 
* Info : ~ Both parameters apply to text screen, NOT the * 

x 


mouse driver's virtual graphic screen - 
RHKKKRK ARKH IKK KKK KKK RRR KK KIKI ARK IKI KIKI IIHR AKAIKE KEKE KAKA KAK KEKE / 


‘ 


void MouSetMoveArea( BYTE xl, BYTE yl, BYTE x2, BYTE y2 } 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
regs.x.ax = 0x0008; /* Funct. no. for "Set vertical Limits" */ 
regs.xX.cx = ROWTOY( yl ); /* Conversion to virtual */ 
regs.x.dx = ROWTOY( y2 ); /* mouse screen ey 
MOUINT (regs, regs); /* Call mouse driver */ 
regs.x.ax = 0x0007; /* Funct. no. for "Set horizontal Limits" */ 
regs.x.cx = COLTOX( xl ); /* Conversion to virtual */ 
regs.x.dx = COLTOX( x2 ); /* mouse screen */ 
MOUINT (regs, regs); , /* Call mouse driver */ 


} 


[RIKKI IK IKI KKI IKK IIH IKI KK IKKE KE KIK IAEA RIKKREKIKIKKEEKKIN 


* Function >MouSetSpeed ‘ 
TO a wa a ak ae ws Se eh es ee os oss ee ems ec a eno oe ne ee eb eb es teak ecw emanate eS kk 
* Task : Determines the difference between mouse movement * 
x speed and the resulting pointer speed on the * 
* screen. * 
* Input parameters : - XSPEED = Horizontal speed , 
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- YSPEED = Vertical speed 
Return value : None 
Info : - Both parameters are based on mickeys 
(mickey / 8 pixel). 


RHR KEKE RE KEKE KEKE EK RIK IRE KKK RE KIRKE KE KEKE KEE KEKKEKKKEEKEKKKKE 


+ + + 
+ + + 


void MouSetSpeed( int xspeed, int yspeed ) 
{ 


union REGS regs; /* Processor regs for interrupt call */ 


regs.x.ax = 0x000f; /* Funct. no. for "Set mickeys to pixel ratio" */ 
regs.X.Cx = xspeed; 

regs.x.dax = yspeed; 

MOUINT (regs, regs); /* Call mouse driver */ 
} 


[RRR KEKE KIKI KEE KAKI AKER AE KKK KEKAKKEK 


* Function >MouMovePtr * 
"IE Vi i cae nw Ss ces coe cab eu Sour och cSt eis is weno ‘chs cms ss log has Sens ns ss sacs css Ss ens maser sss nis ead es eas sete cas es cos toes ee se cn ess Sm sw me es ak 
* Task : Moves the mouse pointer to a specific position * 
* on the screen. * 
* Input parameters : - COL = new screen column i 
bs - ROW = new screen row * 
* Return value : None * 
* Info : - Both parameters apply to the text screen, NOT * 
x * 


to the mouse driver's virtual graphic screen 
RHR KEK KKK EKER IKK KEKE KKK EKER EK KEK KEKE EKER KEKE KEEKEEKERKEKKEKEKEEKKKKKKK / 


void MouMovePtr( int col, int row ) 

{ 

union REGS regs; /* Processor regs for interrupt call */ 
unsigned newrng; /* Range in which the mouse can move */ 


regs.x.ax = 0x0004; /* Funct. no. for "Set mouse pointer position" */ 
regs.x.cx = COLTOX{ moucol = col ); /* Convert coordinates and store */ 


regs.x.dx = ROWTOY( mourow = row ); /* in global variables */ 
MOUINT (regs, regs); /* Call mouse driver */ 
newrng = *(bbuf + mourow * tcol + moucol); /* Get range */ 
if ( newrng != mourng ) /* New range? */ 


MouDefinePtr ((newrng==NO_RANGE) ? stdptr : 
(cur_range+newrng)->ptr_mask) ; 
mourng = newrng; /* Place range number in global variables */ 


} 


[RRR REKRKEEKAKEKREKEKEKKIK KKK KRERAEKEKE KKK KKK EKEKEKKAKEKEKEKKEKKEKEKKKKKKK 


* Function >MouSetDefaultPtr * 
Ba Se a ee a ee a ee ee a ae a a en aS TE SO, kk 
* Task : Defines mouse pointer for screen ranges without * 
* the help of MouDefRange. . 
* Input parameters : STANDARD = Bitmask for standard mouse pointer * 
* Return value : None = 


HHRKKKKKEEK KEK KEKE KEKE ERIK REE KEKE KER EKRKKREKKKIKEKEKEKKEKKEEKKEKEKKEKKRK KKK IK | 


void MouSetDefaultPtr( PTRVIEW standard ) 
{ 


stdptr = standard; /* Place bitmask in global variables */ 
/*-~- If mouse is currently in no range, go direct to conversion ---*/ 
/*-- to new pointer appearance amt / 
if ( MouGetRange() == NO_RANGE ) /* Not in any range? */ 
MouDefinePtr( standard ); /* NO */ 


} 


[RRR IKRE IKARIA IKK KEKE EKER EEEKKEKKKKKKK 


* Function >MouEnd x 
TRS os i et ei ae Se a ne Sew ee ee ee ee Se eee eee Eee 
* Task : Ends mouseC module functions. = 
* Input parameters : None = 
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* Return value : None * 
* Info : Function is called automatically when program * 
- ends, as long as MouInstall is called first. x 


RHR IKKE KERIKERI KIKI KKK IKI KAKA KERR ARK EKER ARKKKEKEEKKEEEKKKKKK / 


void MouEnd( void } 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
MouHideMouse () ; /* Hide mouse pointer from screen */ 
regs.x.ax = 0; /* Reset mouse driver */ 
MOUINT (regs, regs); /* Call mouse driver */ 
free( bbuf ); /* Release allocated memory */ 


} 


[RRR KEKE KEK IKKE KEKE KIKI KEK KEKE KEK KEKE KEK KEKE KEK EEK KKK KEKEKEKKKKEEKKKEEKKKKKKE 


* Function >MoutInit * 
‘We We ss sits in ss se “ii ems el sen ele a ‘te’ ii “os in Si naa es cs i’ a we ee ms cn Ss ae bi ne i i: t-  vmh: te e ms anli  s he oee xr 
Task : Initializes variables and mousec module 
Input parameters : Columns, = Text screen resolution 
Lines 


TRUE if a mouse is installed, else FALSE 
This function must be called as the first one in 


the module. 
KKK KKKK KK KEE KEK KEK KKK KKK ERK KKK KKK KEKE KKK KER EEKKEKEKKEKEKKKKKKKEKKEKEKEKEKEKKKE / 


Info 


+ + + + + 


k 
t 
* 
* Return value 
t 
* 


BYTE MouInit ( BYTE columns, BYTE lines ) 
{ 


union REGS regs; /* Processor regs for interrupt call */ 
tline = lines; /* Store no. of lines and cols */ 
tcol = columns; /* in global variables */ 
atexit ( MouEnd ); /* Call MouEnd at end of program */ 
/*-- Allocate and fill mouse range buffer --------------------------- Lg 


bbouf = (BYTE *) malloc( blen = tline * tcol ); 
MoulIBufFill( 0, 0, tcol-1, tline-1, NO RANGE ); 


regs.x.ax = 0; /* Initialize mouse driver */ 
MOUINT (regs, regs); /* Call mouse driver */ 
if ( regs.x.ax != Oxffff ) /* Mouse driver installed? */ 

return FALSE; /* NO */ 
MouSetMoveAreaAll (); /* Set range of movement */ 
moucol = MoulIGetx (}; /* Load current mouse pos. */ 
mourow = MoulGetyY (); /* into global variables a 4 
/*-- Install assembler event handler “AssmHand" --------------------- */ 


MoulSetEventHandler( EV MOU ALL, (MOUHAPTR) AssmHand ); 


return mavail = TRUE; /* Mouse is installed */ 
} 


[RRA KKK KKK KEK KKK RIK KEKE IKKE KEKE KK KKK KKK KEE KEKRKKKEKEKKKEKKKAKKKK 


i MAIN PROGRAM m 


KHER KEK KKK KEK KEK KEK KKK KKK KKK KEKE KKK KEKE KKK KEK KEKK KEK KKK KEKKEKEEKKKKKKKEKKKEK / 


int main( void } 
{ 


static RANGE ranges[] = /* Mouse ranges */ 
{ 
{ 0, O, 79, O, MouPtrMask( PTRDIFCHAR(0x18), PTRINVCOL) }, 
{ 0, 1, O, 23, MouPtrMask( PTRDIFCHAR(0x1lb), PTRINVCOL) }, 
{ 0, 24, 78, 24, MouPtrMask( PTRDIFCHAR(0x19), PTRINVCOL) }, 
{ 79, 1, 79, 23, MouPtrMask( PTRDIFCHAR(Oxla)}, PTRINVCOL) }, | 
{ 79, 24, 79, 24, MouPtrMask( PTRDIFCHAR('X'), PTRDIFCOLB(0x40) ) }, 
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}; 


printf ("\nMOUSEC - (c) 1989 by MICHAEL TISCHER\n\n") ; 
if ( MouInit( 80, 25) ) /* Initialize mouse module */ 
{ /* OK, there is an installed mouse driver */ 
printf ("Move the mouse pointer around on the screen. When you move\n"\ 
“the mouse pointer to the border of the screen, the\n"\ 
"mouse pointer changes in appearance, depending upon its\n"\ 
"Current position.\n\n" 
“Move the mouse pointer to the lower right corner of the\n"\ 
"screen, and press both the left and right mouse buttons\n"\ 
“to end this demo program.\n" ); 


MouSetDefaultPtr ( MouPtrMask ( PTRDIFCHAR( '[' ), PTRDIFCOL( 3) ) ); 


MouDefRange( ELVEC( ranges ), ranges ); /* Range definition */ 
MouShowMouse () 7 /* Display mouse pointer on the screen */ 
/*-- Wait until the user presses the left and right mouse a—*/ 
/*-- buttons simultaneously, AND the mouse pointer lies int mak / 
/*-- range 4 at / 
do /* Read loop */ 


MouEventWait ( EAND, EV_LEFT PRESS | EV_RIGHT PRESS ); 
while ( MouGetRange() != 4 }; 


return 0; /* Return OK code to DOS */ 


else /* No mouse OR mouse driver installed */ 
{ 
printf ("Sorry, no mouse driver installed.\n"); 
return 1; /7* Return error code to DOS */ 
} 
} 


Assembler listing: MOUSECA.ASM 


J RAARHRKKEKKREKKEKEEKEKKKKEKEKEKEEKKKK HHRKKKKKKEKREKKEKREEKERKEKKRERKEEKEKEKEKEKKEK 9 
ee MOUSECA ai 
ox ccs nas ea: cra dain tm iS om Si hn as es cc seus is mb i'n nin ss cu amu emi ms anc sc ss ms un es leon ean enc i a hm a ee Ss ini Sn enh mh mom is oa ws 
:* Task : Mouse driver event handler intended for bald 
= linking to a C program compiled as a SMALL ns 
77 memory model. *? 
.* i Ss i ca mes sr mb cms oe css ‘aaah ce a em eh essen cui esi Sa cs nl rs i ih ues ems osm atm SGD snes hla is Ve ts ns aise is ne ican ts “cs e's ams ic nai cc como i Sin hd id *»s 
7* Author : MICHAEL TISCHER *; 
3* Developed on : 04/20/1989 Tig 
ok Last update : 06/14/1989 a 
MS a ich sa cs Las Sas esis lets Cath oe tn is ccs ccs Gains seta ca cs ms ts a as sss hn coset cee es aa‘ ea’ enh tam bt cn Gass ak ms iis iss cs lm sca ADS hs eis Ge a “num tins ii tn bs na en tes esc is ac ke 
cf ta 
3* assembly : MASM /MX MOUSECA; 27 
:* .-.. link to program MOUSEC nS 
; KKREKKKEKKKKEKKEKKKEKKEKKEKKKKKEKKKKKKKEKEKEKKKKKKE KEKKKKKKKKKKEKKEKEKKKEK 9 


j== Segment declarat ion s for the C PLOQLAaM =SHSSSSSsSSSS sss sS sss sss SSSs= 


IGROUP group text ;Inclusion for program segment 
DGROUP group const, bss, data ;Inclusion for data segment 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public 'CONST';This segment includes all read-only 
CONST ends ;constants 


_BSS segment word public 'BSS' ;This segment includes all un- 
_BSS_— ends yinitialized static variables 


_DATA segment word public ‘DATA' ;This segment includes all initialized 


zglobal and static variables 
_DATA ends 
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_TEXT segment byte public ‘CODE' 


public _AssmHand 
extrn _MouEventHandler : near 
active db 0 

-- _AssmHand : The event handler 


-~ Call from C: not allowed! 


_AssmHand proc far 


7;Program segment 


7Gives the C program the ability to 
zaccess assembler handler addresses 


;Event handler to be called 


;Indicates whether a call is under 
zexecution 


called by the mouse driver, then 


called by the MouEventHandler(} function 


; Place all processor registers on the stack --- 


active,0 
ende 


cmp 


mov active,1 
push ax 
push bx 
push cx 
push dx 
push di 
push si 
push bp 
push es 
push ds 


mov di,cx 
mov cl,3 

shr dx,cl 
push dx 

shr di,cl 
push di 

push bx 

push ax 

mov ax, DGROUP 
mov ds,ax 


call _MouEventHandler 


add sp,8 


7-~ Pop register contents off of stack 


pop 
pop 
pop 
pop 
pop 
pop 
pop 
pop 
pop 


mov active,0 


7Call still not finished? 
7;NO --> Do not exit call 


;No more calls 


Place all arguments for calling C_FCT on the stack --- 
Call: MouEventHandler( int EvFlags, int ButStatus, 


int x, int y ); 


;Place horizontal coordinate in DI 
;Counter for coordinate number 
7;Divide DX (vertical coord.) by 8 
zand place on the stack 


7Divide DI (horizontal coord.) by 8 
yand place on the stack 


7Push mouse button status onto stack 
7;Push event flag onto stack 


7Move segment address of DGROUP to AX 
7Move AX to DS register 


7C function call 


7;Get arguments from stack 


7;Re-enable call 
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ende: ret ;Return to mouse driver 


_text ends 7End of code segment 
end 7End of program 
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Chapter 15 


Determining Processor 
Types | 


Which 


There are number of utility programs on the market today which can tell you about 
the configuration of a PC. This information can include the amount of available 
RAM, the running DOS version and the type of processor the PC has. 


This information can be very useful for developing programs in high level 
languages, since code generation can be adapted to the particular processor. For 
example, both Microsoft C and Turbo C allow special code generation for the 
8088, the 80286 and the 80386, which makes full use of the capabilities of the 
particular processor and instruction set. This can dramatically improve performance 
for programs which work with large groups of data. One way to take advantage of 
this would be to compile the program once for each of the three processor types. 
Then a program could be developed to serve as the boot for the actual program. 
This boot program would determine the type of processor being used and load the 
main program version most compatible with the processor. 


processor is which? 


This raises the question of how to determine which type of processor is being 
used, since unlike other configuration information, we cannot find this out by 
making a BIOS or DOS call. Unfortunately, there is no machine language 
instruction which instructs the processor to reveal its identity, so we have to use a 
trick. This trick relies on a condition which, according to a few hardware 
manufacturers, is totally impossible. 


This is a test which involves the different ways the various processors execute 
certain machine language instructions. Although processors from the 8086 to the 
80386 are upwardly software compatible, the development of this processor series 
brought small changes in the logic of certain instructions. Since these changes are 
only noticeable in rare situations, a program developed for the 8088 processor will 
also run correctly on all other processors in the Intel 80x86 series. But if we 
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deliberately put a processor into such a situation, we can determine its identity 
from its behavior. 


These differences are only noticeable at the assembly language level, so our test 
program must be written in assembly language. We have included listings at the 
end of this chapter which allow the test routine to be included in Pascal, C and 
BASIC programs as well. 


Bits 12-15 Bits 12-14 


in flag reg. NO in flag reg. NO 
after PUSHF after PUSHF | 80386 
za] =0 
iG ? 
YES YES 
80286 
Top three — 
bits in CL 
excuded by 80186/88 


shift instr. 
? 


Error during 
string instr. 
with segment 
override 


and REP prefix 
? 


NEC V20/V30 


8086/8088 


YES 


NO 


Determining processor type ona PC 
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As the flowchart above shows, the routine consists of several tests which can 
distinguish various processor types from one another. The next test executes only 
when the current test returns a negative response. 


Flag register test 


The first test concerns the different layout of the flag register in the different 
processors. The meaning of bits 0 to 11 is the same in all processors, but bits 12- 
15 are also defined in processors from 80286 up (through the introduction of the 
protected mode). This can be noticed in the instructions PUSHF (push the contents 
of the flag register onto the stack) and POPF (fetch the contents of the flag register 
from the stack). On processors through the 80188 these instructions always set 
bits 12-15 of the flag register to 1, but this doesn't occur in the 80286 and 80386 
processors. The first test in the routine takes advantage of this fact, in which it 
places the value 0 on the stack and then loads it into the flag register with the 
POPF instruction. Since there is no instruction for comparing the contents of bits 
12 to 15, the flag register is pushed back onto the stack with a PUSHF 
instruction. This is so we can get the contents into the AX register with POP AX, 
where we can test bits 12 to 15. 


If all four bits are set, then the processor cannot be an 80286 or an 80386, and the 
next test is performed. However, if not all four bits are set, then we have reduced 
the set of possible processors to the 80826 and the 80386. Since POPF also 
operates differently between these two processors, it is easy to tell them apart. We 
simply repeat the whole process, this time by placing the value 07000H on the 
stack instead of 0. When the flag register is loaded with the POPF instruction, bits 
12 to 14 of the flag register will be set to 1. If these bits are no longer 1 when the 
contents of the flag register are fetched from the stack, then the processor must be 
an 80286, which, in contrast to the 80386, sets these three bits back to 0. The test 
is then concluded for these two processors. 


Narrowing down the field 


If the processor did not pass the first test, the following test will show if it is an 
80188 or 80186. With the introduction of these two processors, the shift 
instructions (like SHL and SHR) were changed in the way they use the CL register 
as a shift counter. While in previous processors the number of shifts could be 
between 0 and 255, the upper three bits of the CL register are now cleared before 
the instructions starts, limiting the number of shift operations. This makes sense 
since a word will contain all zeros anyway after at most 16 shifts (17, if the carry 
flag is shifted). Additional shifts will cost valuable processor time and will not 
change the value of the argument at all. 


The second test makes use of this behavior by shifting the value OFFH in the AL 
register 21H positions to the right with the SHR instruction. If the processor 
executing the instruction is an 80188 or later type, the upper three bits of the shift 
counter will first be cleared, and only one shift is performed instead of 21H shifts. 
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O21H (00100001(b)) number of shifts . 
& O1fH (00011111(b)) mask out the upper three bits 


00O1H (00000001(b)) actual number of shifts 


Unlike its predecessors, which would actually shift the value OFFH to the right 
021H times and return the value 0, the 80188 and 80186 will return the value 
07FH. By checking the contents of the AL register after the shift we can easy tell 
if the processor is an 80188 or 80186 (AL not zero), or not (AL equal to 0). If the 
processor also fails this test, then we know it is an 8088/8086 or V20/30. 


V20 and V30 processors 


The V20 and V30 processors are 8088/8086 "clones" which use the same 
instruction set as their Intel cousins, but which operate considerably faster due to 
the optimization of internal logic and improved manufacturing. This speed also 
results in a higher cost, so some PC manufacturers avoid using these processors. 


In addition to the faster execution of instructions, these processors also corrected a 
small error which occurs in the 8088 and 8086 processors. If a hardware interrupt 
is generated during the execution of a string instruction (such as LODS) in 
connection with the REP(eat) prefix and a segment override, the execution of this 
instruction will not resume after the interrupt has been processed. This can easily 
be determined because the CX register, which functions as the loop counter in this 
instruction, will not contain a 0 as expected after the instruction. 


We make use of this behavior in the test program by loading the CX register with 
the value OFFFFH, and then executing a string instruction 65535 times with the 
REP prefix and segment override. Since even a fast processor needs some time to 
do this, a hardware interrupt will be generated during one of the 65535 executions 
of this instruction. In the case of the 8088 or 8086, the instruction will not be 
resumed after the interrupt, and the remaining "loop passes” will not execute. The 
test program verifies this from the CX register after the instruction has been 
executed. 


Data bus test 


Queue 
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Once we have distinguished between the 8088/8086 and the V20/30, one last test 
is performed for all processors (except the 80286 and 80386). In this test we 
determine if the processor is using an 8-bit or a 16-bit data bus. This allows us to 
tell the difference between the 8088 and 8086, the V20 and V30, or the 80188 and 
the 80186. We cannot determine the width of the data bus with assembly language 
commands, but the data bus width is related to the length of the instruction queue 
within the processor. 


The queue stores the instructions following the instruction currently being 
executed. Since these instructions are taken from the queue and not from memory, 
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this improves execution speed. This queue is six bytes long on processors with a 
16-bit data bus, but only four bytes long on processors with an 8-bit data bus. 


The last test is based on this difference in length. The string instruction STOSB 
(store string byte) used in connection with the REP prefix modifies three bytes in 
the code segment immediately following the STOSB instruction. These bytes are 
placed so that they are found within the queue on a processor with a six-byte 
queue; the processor won't even notice the change. On a processor with a four-byte 
queue, these instructions are still outside the queue, so the modified versions of the 
instructions are loaded into the queue. The program makes use of this by 
modifying the instruction INC DX, which increments the contents of the DX 
register which contains the processor code in the routine. This instruction is 
executed only when the processor has a six-byte queue, and the instruction was 
already in the queue by the time the modification was performed. 


On a processor with a four-byte queue, this instruction is replaced by the STI 
instruction, which doesn't affect the contents of the DX register (or the processor 
code). STI sets the interrupt bit in the processor flag register. Since this procedure 
always increments the processor code by one for 16-bit processors, the processor 
codes in the routine are chosen so that the code for the 16-bit version of a 
processor always follows the code for the 8-bit version of the same processor. 


The following BASIC and Pascal programs use DATA or inline statements instead 
of assembly language. However, we included the assembly language versions of 
these statements here so that you can follow the program logic. The C 
implementation requires direct linking of C and the assembly language routine. 


BASIC listing: PROCB.BAS 


100 CRAKKKKKKKKKKKKKEKKKKEKEEKEKKKKKKKKKEEKEEK KEKE KEKE KEEREKKKKKKKKK 


110 ‘* PROCB = 
120 Ute ee Cee ee meee meee ae ae neonate x 
130 '* Task : Examines the main processor and tells the e 
140 ‘* user the processor type sal 
150 '* Author : MICHAEL TISCHER we 
160 '* Developed on : 09/06/1988 ios 
170 '* Last update : 05/23/1989 “es 
180 PRK KKK KKEKEKEKKKKKEKEKEKKKKKKEKKKKEK KKK EKKKKEKEKKKKKHEKEKREKEKEKKEKKER 
190 ° 


200 CLS : KEY OFF 

210 PRINT“ATTENTION: This program should only be run when GW-BASIC is loaded from" 
220 PRINT“the DOS prompt using the command <GWBASIC /m:60000>." 

230 PRINT : PRINT“If this isn't the case, press the <s> key to etal 

240 pre: Orber wee press any other key to continue... ae 

250 A$ = INKEYS : IF A$ = "s" THEN END 

260 IF AS = “" THEN 250 


270 CLS ‘Clear screen 
280 GOSUB 60000 ‘Install assembler routine 
290 CALL PT (PTYP%) ‘Determine processor type 
300 RESTORE 1000 ‘Read DATA statements starting at line 1000 
310 FOR I% = 0 TO PTYP% ; READ PS : NEXT ‘Get processor name 
320 PRINT “PROCB —- (c) 1988 by MICHAEL TISCHER" 

330 PRINT “Your PC contains a(n) “;P$;" processor." 

340 END 

350 ' 


1000 DATA “INTEL 8088", “INTEL 8086", “NEC V20", “NEC V30" 
1010 DATA “INTEL 80186", “INTEL 80188", “INTEL 80286", “INTEL 80386" 
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1020 ! 

60000 UKKKKKKKAKAKAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KKK KKK KKKKKKKKKK 
60010 '* Routine for determining onboard processor type ale 
60020 ' *-—--————-~— - - rn errr enn ws 


60030 '* Input 
60040 ** Output 


none 


xe 


PT is the starting address of the assembler routine *' 


60050 '* Call to the routine:CALL PT (PTYP%) sae 


60060 URKHEIM KEKKEEKEKKKEKKEKEK 


60070 ' 


60080 PT=60000! 
60090 DEF SEG 
60100 RESTORE 60140 


60110 FOR I% = 0 TO 105 


60120 RETURN 


60130 ' 


60140 DATA 85,139, 236, 
60150 DATA 0,240,116, 
60160 DATA 112,116, 54, 
60170 DATA 232,117, 18, 
60180 DATA 11,201,116, 
60190 DATA 23, 0,250, 
60200 DATA 126, 6,137, 
60210 DATA 227 


‘Starting address of BASIC segment routine 
‘Define BASIC segment 


: READ X% : POKE PT+1I%,X% : NEXT "POKE routine 
‘Return to caller 


156, 6, 51,192, 80,157,156, 88, 37, 0,240, 61 
19,178, 6,184, 0,112, 80,157,156, 88, 37, 0 
254,194,235, 50,144,178, 4,176,255,177, 33,210 
178, 2,251,190, 0, 0,185,255,255, 243, 38,172 

2,178, 0, 14, 7,253,176,251,185, 3, 0,232 
243,170, 252,144,144,144, 66,144,251, 50,246,139 
21, 7,157, 93,202, 2, 0, 95,131,199, 9,235 


Assembler listing: PROCBA.ASM 
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FRA KKKKKKEKRKREKEKKRKEEKEKEKEEKEREREREREKREKKEKEREREKREKEKEKEREKKKEKKEKEKEKEKEKKEKEEK 0 


+ + 


=e %e Me SMe 


PROCBA * 

sai tas i tn iy Ss chs ms as me i i eis em iy mas iis mis pb mas nics et mse cn cms ms as ne ss ee le um ms es ls a Rs na la cc * 
Determines the type of processor installed in * 

a PC * 

This BASIC version of the program converts * 

DATA statements into machine language, and * 

executes this code in the BASIC program * 

Te ing SS cs sce ea ns ls Sew Gas ein a Sows coos ens Gas ds ec tam io cs ams aces Gas See mn nes dm Me aw ein ea an ae ao een een ames wean cmaaian * 
MICHAEL TISCHER * 

09/05/1988 ~ 

05/24/1989 * 


KAKEKKHEKEKKKEKEKRKKKEKEKKEKEAKKEKKEKKKKKKEKEKEREKKKE KEKE KKKEKEKKAKKKKK 


* Task: : 
* 

ak 

gv 

ok 

| 4 

ok 

td 

ok 

f 

7s Author ; 

zt Developed on : 

3* Last update : 

ok 

c 

7% assembly : 

ok 

f 

ok 

v 

ox 

v 

ox 

t 

ox 

v 


;== Constants 


p_ 80386 
p 80286 
p_ 80186 
p 80188 


get proc 


equ 
equ 
equ 
‘equ 


@ 

Q 

oS 
OrFPRFNWH UD ~) 


segment para 


org 100h 


: MASM PROCBA; 


* 
"™s “se Ne “Ne Ve Re Ve Vs Be Np Ns Ne We Be Be We Vs Ba % 


x 
LINK PROCBA; * 
EXE2BIN PROCBA PROCBA.BIN * 
convert to DATA statements and add to © 

a BASIC program * 

x 


ea ee ss a ae ea a 


;Codes for different processor 
;types 


*CODE' 7Definition of CODE segment 


assume cs:code, ds:code, ss:code, es:code 


proc far 


push bp 
mov bp,sp 


7;GW-BASIC waits for CALL FAR procedure 


7Push BP onto stack 
;Move SP after BP 
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not_a_ 386 


t88_ 86 


t86 1: 


pushf 
push es 


;Save contents of flag registers 
7Mark ES 


;-- test for 80386/80286 - ----------------------------------- 


xor ax,ax 
push ax 

popf 

pushf 

pop ax 

and ax,0f000h 
cmp ax,0f000h 
je not_a 386 


7;Set AX to O and 

;push onto stack 

7Get as flag register from stack 
;Put on stack again and 

;return to AX 

7Don't clear the top 4 bits 

sAre bits 12-15 all equal to 1? 
7YES-> Not an 80386 or 80286 


j-- Test to see if it should be handled as 80386 or 80286 ---- 


mov dl,p 80286 
mov ax,07000h 
push ax 

popf 

pushf 

pop ax 

and ax,07000h 
je pende 

inc dl 

jmp pend 


7;This narrows it down to one of the 
ztwo processors 

z;Push value 07000H onto the stack 
7;Return as flag register 

zand push back onto stack 

;Pop off and return to AX register 
7;Do not mask bits 12-14 

zAre bits 12-14 equal to 0? 

7YES-> Treat it as an 80286 


s;NO-> Treat it as an 80386 
7;Test ended 


rows Test. for B0186,or 80188 Se Se ee eee neo 


Test for NEC V20 or 


lods byte ptr es:[si] 


Test for ...88 or .. 


label near 
mov dl,p 80188 
mov al,Offh 
mov cl,021h 
shr al,cl 

jne t88 86 
mov dl,p _v20 
sti 

mov si,O 

mov cx,O0ffffh 
rep 

or CX, CX 

je t88 86 
mov dl,p 8088 
Pieri 

label near 
push cs 

pop es 

std 

mov al,0Ofbh 
mov cx,3 

call get_di 
cli 

rep stosb 

cld 

nop 

nop 

nop 


;Load code for 80188 

7;Set all bits in AL register to 
sNumber of shift operations after CL 
7;Shift AL CL times to the right 

;If AL<>0O then it must be handled as 
780188 or 80186 


j;Load code for NEC V20 

;Interrupts should be enabled starting 
jwith the first byte in ES 

7Read a complete segment 

7REP with segment override 
zworks only with NEC V20/V30 chips 
;Has the complete segment been read? 
7YES--> it's a V20 or V30 


7;NO--> must be an 8088 or 8086 


-86 / V20 or V30 ------99 2-2-9 = 


7Push CS onto the stack 

z;and pop off to ES 

7Using string inst. count backwards 
7Code for "STI" 

7Execute string instruction 3 times 
7Call starting address DI 

7Suppress interrupts 


7Using string inst. ocunt backwards 
7Fill queve with dummy command 
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inc dx ;Increment processor code 
nop 
q_end: sti : 7Re-enable interrupts 
7 2 A ee ED SE SS SOD SE SHE ENED MEE NED ETD NS GRY SENN an GEES GEA GED GED GORD ED SED GS GER GED ND CEE LED GDN SSNED SENET GND SNE GS AEND SEED OL SD SED GND MEN GENE GOURD GLAD GED GETTD GHUTE SOND GD CELE GOOD ENED ckeD CENA WEED GRD SEEN 
pend label near 7End processor test 
xor dh,dh 7Set high byte or processor code to 0 
mov di, (bpt+6] 7Get addr. of processor code variables 
mov [di],dx 7;Place processor code in this variable 
pop es ;Pop off stack and place in ES 
popf 7Pop flag register off of stack and 
pop bp 7Return BP 
ret 2 7;FAR return takes us back to GW-BASIC 
;Remove parameters from stack 
getproc endp 7End of PROG procedure 
7-- GET DI Check with DI for 88/86 Test ----------------------~---------— 
get_di proc near 
pop di 7Pop return address off of stack 
add di,9 ;Remove starting 9 bytes from it 
jmp t86 1 ;Return to the test routine 


get_di endp 


code ends 7End of CODE segment 
end getproc 


Pascal listing: PROCP.PAS 


{BRR R RRR KH KERR IK KARE RK KKK KEK ERK RK RE KEE KRKIERE EKER KEKKKEKEKKKEKE } 


{* PROCP * 3 
{* Ss ee ee eee eee ee ee ee ee ei *} 
{* Task : Examines the processor type in the PC and *} 
{* tells the user the processor type * 
{* es is i i cl is ci es a hips a a li ll ale i i cet nm Seb er si Gi Wc sud is li ev cl i im ha i a il ce’ mel wip. i i tc i msi i ab a. *} 
{* Author : MICHAEL TISCHER ms 
{* Developed on : 08/16/1988 *} 
{* Last update : 05/23/1989 *} 


{BAAR KH HAKKAR KIRKE KK ER KREER EKER IKKE ERIK EKER AREER AKKEKK KE | 


program PROCP; 


type ProNames = array(0..7] of string[11]; { Array of processor names 


a 


const ProcName ;: ProNames = ( ‘INTEL 8088', { Code 0 } 
‘INTEL 8086', { Code 1 } 
"NEC V20', { Code 2 } 
"NEC V30', { Code 3 } 
‘INTEL 80188', { Code 4 } 
‘INTEL 80186', { Code 5 } 
‘INTEL 80286', { Code 6 } 
‘INTEL 80386' ); { Code 7 } 


{RRR IRI I IR IIR RIK RIK RIKKI RRR KR KIRK I KEKE RIK EEK KEKKEKEKEKKKK } 


{* GETPROC: Determines processor type in PC *} 
{* Input : none *} 
{* Output : Processor code (see CONST) *} 
{* Info : This function can be used in a program when added as *} 
(* a UNIT *} 


[ERR RHKE RRR KERR ERK KERR KERR ERE RKREK ERE KEKE ERE RE KERERERKEEKKEKE | 


function getproc : byte; 


begin { Machine code routine for determining processor type } 
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inline ( 
$9C/$51/$52/$57/$56/$06/$33/$C0/$50/$9D/$9C/$58/$25/$00/ 
$F0/$3D/$00/$F0/$74/$13/$B2/$06/$B8/$00/$70/$50/$9D/$9C/ 
$58/$25/$00/$70/$74/$36/SFE/$C2/$EB/$32/$90/$B2/$04/$B0/ 
SFF/$B1/$21/$D2/$E8/$75/$12/$B2/$02/SFB/SBE/$00/$00/$B9/ 
SFF/SFF/S$F3/$26/S$AC/$0B/$C9/$74/$02/$B2/$00/S0E/$07/$FD/ 
$B0/$FB/$B9/$03/$00/$E8/$16/$00/SFA/$F3/SAA/$FC/$90/$90/ 
$90/$42/$90/$FB/$88/$56/SFF/$07/S$5E/S$5F/$5A/$59/$ 9D/SEB/ 
$07/$90/$5F/$83/$C7/$09/SEB/SE4 

); 
end; 


{ RR RRRKRRK RR RERKRKRKRRERKEKKKRKRKRKEKKKK KEKE KERR REE EERE EKREEHE EEE HATE EEE) 


{"* MAIN PROGRAM ee} 


{ RE RAKKKERRRKEKKKRKKEK EKER KEEKEK KKK EKEKKEKEKKKKEK EKER KKEKKEEKKEKKEKEKEEKKEKEKEKKKKE | 


begin 
writeln('PROCP - (c) 1988 by MICHAEL TISCHER'); 
writeln(#13#10, ‘Your PC contains a(n) ‘, ProcName(getproc], 
‘ processor.'); 
writeln (#13#10); 
end. 


Assembler listing: PROCPA.ASM 


KHAKI KEKE KKK KEKE KKKKAKREKEEKKKKKKKKKK 
* 


f v 
; PROCPA as 
oe se Si i si i a Ge sth ltd Sate si: ts es lei sc wi: ni us ip i-inr ls sm el el eh ei’ Wl is ais KS 
rhe: Task : Determines the type of processor installed in *; 
ae a PC. Sat 
eX This version is converted by INLINE statements *; 
-* and then used by a Pascal program. bai 
* ain eis mets en a Ceca tas Shap in cm’ Gm ce sll ria cn cass Sem i ss cs em iin ces i ms hn ses Sa tin con xin es aso “cass as fe sm cas cs ea er sa casas ce cas ew suis ce sd cs’ x. 
ss Author : MICHAEL TISCHER *; 
om Developed on : 08/22/1988 4 
st Last update : 05/24/1989 i? 
s* Ss et ac a a a ah a a es a ae sc es soy ens es ae nin cas a iss es a i ess ee cs ees See ew as 
7* assembly : MASM PROCPA; ar 
ies LINK PROCPA; ae 
o EXE2BIN PROCPA PROCPA.BIN a 
o* -.-. convert to INLINE statements and add to *s 
ze Pascal programs as 
FREER ERE KHER RK ERK KR RE RK KKK KEKE KEK HER RE EK KIRK EKER KKK KR EEK IER ER EKKEKKEEK KKK KKK EK 0 


p_ 80386 equ 7 ;Codes for different types of 

p_80286 equ 6 ; processors 

p_ 80186 equ 5 

p 80188 equ 4 

p_v30 equ) 3 

p_v20 equ) 2 

p_8086 equ 1 

p 8088 equ) 0 

code segment para 'CODE' ;Definition of CODE segment 
org 100h 


assume cs:code, ds:code, ss:code, es:code 


getproc proc near 7This program is the essential main 
7; program 
pushf 7Get contents of flag registers 
push cx 7Get contents of all altered registers 
push dx zand push them onto stack 
push di 
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not_a_ 386 


t88_ 86 


t86 1: 


push si 

push es 

g-- Test for 80386/80286 -—--------------- <= - nn - 
xor ax,ax 7;Set AX to 0 

push ax zand push onto stack 

popf 7Pop into flag register from stack 
pushf ;Return to stack 

pop ax ;And pop back into AX 

and ax,0f000h pAvoid clearing the to 4 bits 

cmp ax, O0f000h ;Are bits 12-15 all equal to 1? 

je not_a 386 7YES->Not an 80386 or an 80286 


7-- Test whether to handle it as an 80386 or 80286 ----------- 


mov dl,p 80286 ;This narrows it down to one of 

mov ax,07000h zthe two processors 

push ax 7;Push value 7000H onto the stack 

popf 7;Pop off as flag register 

pushf yand push it back onto the stack 

pop ax 7Pop off and return to AX register 

and ax,07000h 7Avoid masking bits 12-14 

je  pende zAre bits 12-14 all equal to 0? 
sYES->Handle it as an 80286 

inc dl 7;NO->Handle it as an 80386 

jmp pende ;End of test 


r-~- Test for 80186 or 80188 -—-----~--~-------~—=--- 


label near 

mov dl,p 80188 s;Load code for 80188 

mov al,Offh ¢Set all bits in AL register to 1 
mov cl,021h ;Number of shift operations after CL 
shr al,cl 7Shift AL CL times to the right 

jne t88 86 ;If AL is unequal to 0 it must be 


yhandled as an 80188 or 80186 


pov Lest for NEC ‘V20. Or V30 -reeraeas asa e ee eae ee 


mov dl,p v20 ;Load code for NEC V20 

sti ;Interrupts should be enabled starting 

mov si,0O ywith the first byte in ES 

mov cx,O0ffffh ;Read a complete segment 

rep lods byte ptr es:{si] ;REP w/ segment override only 
gworks with NEC V20 and V30 processors 

or CX, CX ;Has complete segment been read? 

je t88 86 7YES-> V20 or V30 

mov dl,p 8088 ;NO-> Must be an 8088 or 8086 

z~- Test for 8088 or 8086/V20 or V30 ----------9 nnn 

label near 

push cs ;Push CS onto stack 

pop es 7Pop off to ES 

std ;Using string inst. count backwards 

mov al,Ofbh sInstruction code for "STI* 

Mov cx,3 7Execute string instruction 3 times 

call get di ;Get starting address of DI 

cli ;Suppress interrupts 

rep stosb 

cld ;Using string inst. count backwards 

nop sFill queve with dummy instruction 

nop 

nop 
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inc dx ;Increment processor code 
nop 
q_end: sti ;Re-enable interrupts 
7 ea ee cee ce eat cave GENE er GE UU amet Ga He SE SEE SED GOES Ee Mat ED SNR SED SS STS MaRS GUE Gel SEED MS HED SEAS SEED SHEED GAY SENET SEED GED EAE SIND GS GS UD EN RD LE GED SS SND SEND GRE Gately SED EE OED AND SUEY Gate Ma STE ee ME 
pende label near ;End testing 
mov [{bp-1],dl 7;Place processor code in return var. 
pop es 7;Pop saved registers from 
pop si ;stack 
pop di 
pop dx 
pop Cx 
popf 7;Pop flag register from stack and 
jmp endit 7Return to calling program 
getproc endp 7End of PROG procedure 
;-~- GET DI examines DI for 88/86 test ~--~----—-----9-- 9 ern 
get_di proc near 
pop di q 7;Pop return address off of stack 
add di,9 f 7;Take first 9 bytes from there 
jmp t86 1 = ;Return to the testing routine 
endit label near 


get_di endp 


code ends 7;End of CODE segment 
end getproc 


C listing: PROCC.C 


[BERR KKK KIRK EKER KEKE KEKE KEK KIKI KEKE RK KK EEK KEKE KTR EKKKEEKEREKEKKK / 


/* PROCC */ 
/* es Sc Sa Sem eed i in iy sm ca Ss os ck cs nn cs als civ ina sce hes es ins ees ons ne ain ce ews es wc cass seo ee Gob Ee ee x/ 
| isi Task : Determines the processor type in a PC */ 
/* et es cs ie ssc ss sme cea sco as ee nh is cs es a csc cm cs me a ass cn wi cms mca els aes Secs cas es ke mcs cme ss a ens case es ee cae ns nb cel iN cots eae nn ks i es ml Sc x/ 
{* Author s MICHAEL TISCHER */ 
/* Developed on =: 08/14/1988 */ 
/* Last update : 06/22/1989 nf 
/* fei pig ua Sa a ey a en a as les ems en een ec ses esc acy es cs Sop cans ty ces en em eis camp Cnc mn ils cca is cn eps as ss ems sede as re tes mb Ged af 
/* (MICROSOFT C) xf 
is Creat ion : CL /AS /c PROCC.C */ 
/* LINK PROCC PROCCA */ 
[* Call : PROCC */ 
/* Ni a sc a nS ns cea Sas as cn wc es ses can ce ec cas Sas cow Sos ces si abs cw Sean ms cs “eis mts ses oc es i hs Uc el etna nb tintin gs em in tn sco en i x / 
/* (BORLAND TURBO C) */ 
[* Creation : Create a project file containing these lines: */ 
YS PROCC */ 
[* PROCCA. OBJ */ 


[ERK KKKK ARKH IEKKIKKKKEREK AKER KERIKERI KEKE KEK IKEKEREKREEKKAKAKKEKK / 


extern int getproc() . /* Includes the assembler routine */ 
[BARAK IK IKK IRE KIKI AKKIIAKK KI KKK IK IKK KEKE AIKEEIAK AERA EKKKKHAKKK / 
[et main program af 


[BRR KKAKKIKKKKIKKKE KKK AKI H KK KKEKK IIR KKKEK KEIRA IKERAKKEKEKIAKKK / 


void main () 


{ 


static char * procname[] = { /* Vector w/ pointers to proc. names */ 
"Intel 8088", /* Code 0 */ 
"Intel 8086", /* Code 1 */ 
"NEC V20", /* Code 2 */ 
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“NEC V30", /* Code 3 */ 
"Tntel 80188", /* Code 4 */ 
"Intel 80186", /* Code 5 */ 
“Intel 80286", /* Code 6 */ 
“Intel 80386" /* Code 7 */ 


}F 
printf ("\nPROCC (c) 1988 by Michael Tischer\n\n") ; 


printf ("This PC contains a(n) %s processor\n", 
procname[ getproc() } ); 


Assembler listing: PROCCA.ASM 


KKK KEKE KEKE KEKK KEKE K KEKE KEKE KEEKEKREKEKKEKEKEKEKEKKKKKE © 
* 


rg 
ve. 
eo) 
Q 
aD 
> 

+ 


* 


* 
=a Ne Ne 8 


, 

7 

? 

. Task : Make a function available to a C program which * 
7” examines the type of processor installed ina *; 
is PC and informs the calling program of this =s 
7* information. Se 
ae cou aes Sr sis coi cs Wn toes so shih ct tons sis em mus cu ie eb ets i magn em ei nei ath i sce cn os im ei em ii ao’ ui lsu hem bc ct Ge eh at in ti bs sin tm soe ns mi 8 
* Author : MICHAEL TISCHER ae 
;* Developed on: 08/15/1988 *; 
ie Last update : 05/24/1989 *; 
ax ere ee cee ee a cen (Eee, SEED NS sans GEE SUES sane GEE OUEP NW eictin COA ED ENED ‘AE SEALED Gam CuED COED gmt: GEWUED GENIE Gude GENEID GED SANNND GEE RID SHOR QHGRED GENES GEM SALGRG GENESD GENER We GEED GEA HEED GED SEND GOED GEAND GOST CASTS GHG) GAS SEED GHG SOD SAEED SEED GOED SASHA SENED UE GENES SEED Gane wenn COO. ke 
tf v 
i assembly : MASM PROCCA; < 
res »». link to a C program xs 
PRA AKKKAKREKREREEKEKR EKER KEKE KEK KEKE KKK KEKEKREKEKKERKEKKEREREKKKKEE 9 


IGROUP group text ;Include program segment 
DGROUP group const, bss, data ;Include data segment 
assume CS:IGROUP, DS:DGROUP, ES:DGROUP, SS:DGROUP 


CONST segment word public ‘CONST';This segment includes all read-only 
CONST ends sconstants 


_BSS segment word public ‘BSS' ;This segment includes al un-initial- 
_BSS ends ;ized static variables 


_DATA segment word public ‘DATA' ;This segment includes all initialized 
;gobal and static variables 


_DATA ends 


p_80386 equ 7 ;Codes for different processor tpyes 
p 80286 equ 6 

p 80186 equ 5 

p 80188 equ 4 

p_v30 equ) 3 

p_v20 equ) 2 

p_8086 equ. l 

p_8088 equ 0 

7== Program =S=SS=SSSsssssssses res Sas SSeS SS SSS SSS SSS SS SS SSS SSS SS SSS SSS 


_TEXT segment byte public ‘CODE' ;Program segment 


public —_getproc ;Function made available for other 
; programs 


7~- GETPROC: Determines the type of processor in the current PC ~-------- 
;-~- Call from C : int getproc( void ); 
77-~ Output : The processor type!s number (see constants above) 


_getproc proc near 


pushf ;Secure flag register contents 
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7~~ Test for 80386/80286 -—--~<-——-~- nnn nen nn 


xOr ax,ax 7Set AX to 0 

push ax zand push onto stack 

popf 7Pop flag register off of stack 

pushf 7Push back onto stack 

pop ax zand pop off of AX 

and ax,0f000h ;Do not clear the upper 4 bits 

cmp ax,0f000h zAre bits 12-15 al equal to 1? 

je not_a 386 7YES --> Not an 80386 or 80286 

7-- Test for handling as an 80386 or 80286 ~------------------ 

mov dl,p 80286 zIn any case, this routine checks for 

mov ax,07000h 7one of the two processors 

push ax 7Push 07000h onto stack 

popf 7Pop flag register off 

pushf zand push back onto the stack 

pop ax 7;Pop into AX register 

and ax,07000h ;Bits 12-14 not included 

je  pende 7Are bits 12-14 all equal to 0? 
7;YES--> Handle it as an 80286 

inc dl 7;NO --> Handle it as an 80386 

jmp pende zEnd test 

7;-- Test for 80186 or 80188 ~-----~---~---~-------------------- 


not_a_ 386 label near 


mov dl,p 80188 ;Load code for 80188 

mov al,Offh 7Set all bits in AL register to l 

mov cl,021h ;Move number of shift operations to CL 
shr al,cl 7;AL CL shift to the right 

jne t88 86 7If AL <> 0, handle is as an 


780188 or 80186 


go> Test. f0r NEC V20 or V30 Seeq=S4545—-S == 55 


mov dl,p _v20 7;Load code for NEC V20 

sti 7;Enable interrupts 

push si ;Mark contents of SI register 

mov si,0 7Starting with first byte in ES, read 
mov cx,0ffffh 7a complete segment 


rep lods byte ptr es:[{si] ;REP with a segment override 
7 (works ony with NEC V20, V30) 


pop si 7Pop SI off of stack 

or cx,cx ;Has entire segment been read? 
je t88 86 7YES--> V20 or V30 

mov dl,p 8088 7NO --> Must be 8088 or 8086 


;-- Test for 88/86 OF V20/V30 ~—we meen nner ren nn 


t88 86 label near 


push cs ;Push CS onto stack 

pop es sand pop ES off 

std 7Increment on string instructions 
mov di,offset q_end : 

mov al,Ofbh ;Instruction code for “STI" 

mov cx,3 ;Execute string instruction 3 times 
cli ;Suppress interrupts 

rep stosb 

cld ;Increment on string instructions 
nop ;Fill queue with dummy instructions 
nop 

nop 

inc dx ;Increment processor code 
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nop 
q_end: sti 7Re-enable interrupts 
? eee aS Ue CD ED EY Ee NE ET OE Ge ND GD cane SED Ga SD UP EE GE ED GR ED ED OD RD SUE ie ED we GT OD CED RD EEF GD GED aE GETS ET ED ES UD Gn GEE RED CEE aE OED Gn GD COD GD mm CET UR OEE OO eR eR 
pende label near 7End testing 
popf ;Pop flag register off of stack 
xor dh,dh ;Set high byte of proc. code to 0 
mov ax, dx ;Processor code=return value of funct. 
ret 7;Back to caller 
_getproc endp zEnd of procedure 
_text ends 7End of program segment 
end 7End of assembler source 
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PC Hardware Interrupts 


Now that you're more familiar with the DOS and BIOS interrupts that are triggered 
by software, let's look at hardware interrupts. As the term suggests, these 
interrupts operate mainly through calls from PC hardware. 


We'll begin with the interrupts which are called directly by the processor. These 
eight interrupts can also be triggered by software through the use of the INT 
instruction. 


Interrupt OOH: Division by zero 


The 8088 has two assembly language instructions (DIV and IDIV) which permit 
division of a 16-bit or 32-bit whole number by an 8-bit or a 16-bit whole number. 
According to the general rules of mathematics, division by zero is illegal. This 
means that you cannot perform the equation 485/0. The equation has no result. 
Because of this, the 8088 prohibits any divisions using a denominator of 0. If a 
division by zero occurs, the processor triggers interrupt 0. The vector assigned to it 
is pointed to by DOS during its initialization to its own routine. During the call 
of this interrupt, the DOS routine call executes. Most versions of DOS display a 
"Division by Zero" message. The program then continues with the instruction 
following the division that caused the error. 


Interrupt 01H: Single step 


The CPU calls this interrupt when the TRAP bit in the flag register of the CPU is 
set to 1. The interrupt then receives a call after every execution of a machine 
language instruction. This interrupt allows the user to trace the execution of every 
instruction in a assembly language program to determine changes in register 
contents or the instructions executed. 


Constant re-execution of interrupt 1 during an execution of interrupt 1 could cause 
infinite recursion, and an eventual stack overflow. To prevent this, the processor 
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resets the TRAP bit during entry into the interrupt routine. It stores the complete 
flag register and the TRAP bit on the stack. 


If an IRET instruction ends this interrupt routine, it automatically sets the TRAP 
bit to the old value by restoring the complete flag register from the stack. After 
completion of the next instruction, interrupt 1 is recalled. Once the programmer 
has obtained all desired information about the program, the TRAP bit can be 
disabled. However, the program being examined doesn't know it's being run in 
single-step mode, and has no instruction to reset the TRAP bit in the flag register. 


Resetting the TRAP bit 


The key to this problem lies in interrupt 1's routine. This is where the TRAP bit 
must be reset. Even this is somewhat complicated, since the bit was reset during 
the call of this routine, then later reset as part of the flag register from the stack. 
The only option of resetting the TRAP bit is taking the flag register from the 
stack from within the interrupt routine, resetting the TRAP bit and return the 
complete flag register to its original position on the stack. If an IRET instruction 
then terminates the interrupt routine, the CPU restores the flag register from the 
stack. Since the TRAP bit is no longer set, no additional calls of interrupt routine 
result, and the program executes undisturbed. 


Interrupt 1 is rarely executed in application programs. Because of this, DOS sets 
the vector of interrupt 1 to an IRET instruction. If a program accidentally sets the 
TRAP bit, nothing happens aside from slower execution, since interrupt 1 
executes after every instruction. Interrupt 1 is most useful in utility programs 
(e.g., the DEBUG program) which permit program execution in trace mode, 1.e., 
execution of every machine language instruction at slow speed. 


Interrupt 02H: NMI 


This non-maskable interrupt (NMI) is so designated because it cannot be masked 
(i.e., you cannot prevent this interrupt's execution). You can suppress the 
execution of all interrupts using the CLI instruction, except this one. NMI alerts 
the user of any errors in RAM. These errors can be caused by defects in one of the 
system's RAM chips. Since a defective RAM chip can cause serious damage and 
data problems in the system, this interrupt receives top priority over all others. 


During the system boot, DOS points the vector to its own routine. If a RAM error 
does occur, this calls the proper BIOS routine which displays a message on the 
screen and stops the system. 


Interrupt O3H: Breakpoint 
This interrupt is also used in utility programs. Unlike the other interrupts, which 


are Called by two-byte-long assembly language instructions (byte 1=CDH, byte 
=interrupt number), interrupt 3 can be called with a single-byte assembly 
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language instruction (CCH). This interrupt is very useful for testing programs up 
to a certain point in the code. Interrupt 3 halts a running program, and allows the 
user to examine the current contents of the registers. 


Applying interrupt 3 


Using a specific utility program for reference (e.g., DEBUG), you place a call for 
interrupt 3 in the program in process where you want execution to stop. When the 
processor reaches this location during program execution, it calls interrupt 3. The 
testing program contains a routine which displays the current register contents and 
other data. Then this routine replaces the interrupt 3 call with the instruction 
which formerly occupied its location. 


You could argue that instead of the call for interrupt 3, any other interrupt could be 
called to interrupt the program, if a suitable interrupt routine had been installed to 
display register contents, etc. Interrupt 3 offers some advantages over this. It can 
be called with a single-byte instruction. 


Imagine a program in which a RET instruction occurs at some location. This 
instruction is one byte long and normally ends a subroutine. Another subroutine 
follows which starts with an assembly language instruction. The user wants to 
examine the register contents at the end of the first subroutine. He would place a 
breakpoint (the call for interrupt 3) at the same location as the RET instruction. 


The single-byte instruction to call interrupt 3 has an advantage here. If this 
instruction was two or more bytes long, it would overwrite the RET instruction, 
and part or all of the first instruction in the following subroutine. If this program 
call occurred in the course of execution, the program code would change and a crash 
could happen. This doesn't happen since the instruction for calling interrupt 3 is 
only one byte. At worst it would overwrite only one instruction. 


This interrupt has no application other than use with a testing/debugging utility. 
Otherwise, DOS points to a routine which contains an IRET (Interrupt RETurn) 
instruction, which immediately returns the system to the interrupted program. 


Interrupt 04H: Overflow error 


This interrupt can be called by a instruction which is based on a condition. It's the 
INTO (INTerrupt on Overflow) assembly language instruction which only calls 
interrupt 04H when a set overflow bit occurs in the flag register during execution. 
This can happen after math operations (e.g., multiplication using the MUL 
instruction), if the result of this operation cannot be represented within a set 
number of bits. This interrupt can also be called using the normal INT instruction, 
but this instruction doesn't read the status of the overflow bit. Since this interrupt 
is seldom used, DOS sets it to an IRET instruction. 
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Interrupt O5H: Hardcopy 


Interrupt OSH belongs with the BIOS interrupts, even though it is technically a 
hardware interrupt. Pressing the <Prt Sc> key calls this interrupt through BIOS. 
This key has labels which differ from one manufacturer to another. The Tandy 
1000 HD version is labeled <PRINT>, but most others have <PrtSc> labels. This 
key sends the current contents of the screen to a printer interfaced to the PC. This 
printout is called hardcopy. 


DOS initializes the vector of this interrupt in the vector table. Both assembly 
language programs and programs written in high level languages can access this 
interrupt using the INT instruction. 


Interrupts O6H—07H: Unused > 


At the time of this writing, interrupts 06H and 07H are unused. They are reserved 
for later use, but can be used now for other applications. 


Interrupts O8H—OFH 


Interrupts 08H to OFH are generated by the 8259 interrupt controller. This chip 
receives all interrupt demands within the system first. It determines the priority in 
which multiple interrupt requests must be executed. The interrupt given highest 
priority passes through the INTR line to the CPU. Up to eight interrupt sources 
(devices) can be connected to the 8259, with each device assigned a different 
priority. With the help of the interrupt bits in the flag register, the CPU can 
suppress all interrupt calls from the 8259 (except NMI interrupt 2—see above). 


Interrupt generation from special equipment can be prevented. For this the interrupt 
mask register of the 8259 must be accessed through port 21H. The eighth bit of 
this register is connected to the maximum of eight devices which create interrupts. 
Bit 0 represents device 0, bit 7 the device with the number 7. If a bit has the value 
0, the CPU receives the interrupt calls generated by the device assigned to it from 
the 8259. If it contains the value 1, the interrupt calls are suppressed. If several 
interrupt calls occur at the same time, the device which is connected to bit 0 gets 
the highest priority and bit 7 the lowest priority. If the highest priority interrupt 
has been processed, theoretically the interrupt with the next priority down can be 
transmitted from the 8259 to the CPU. 


Interrupt instruction register 
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The 8259 knows about the completion of an interrupt call through its interrupt 
instruction register at port address 20H. This register enables communication 
between a program and the 8259. When an interrupt initiated by a device attached 
to the 8259 finishes processing, it must send an OUT assembly language 
instruction which transmits the value 20H (an EOI = End Of Interrupt) to this 
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port. This tells the 8259 that interrupt processing is done, and the next interrupt 
can be called. 


The bit assignment in the interrupt mask registers (i.c., device assignments and 
priorities) differ between individual members of the PC family. You can usually 
assume that the device connected to bit 0 of the interrupt mask register triggers 
interrupt O8H. The device connected to bit 1 triggers interrupt 09H, etc. Interrupt 
OFH (the last interrupt called by the 8259) is triggered by the device attached to bit 
7 of the interrupt mask register. Generally these eight interrupts have designations 
of IRQO, etc. up to IRQ7. IRQ stands for Interrupt ReQuest. 


AT interrupt controllers 


The AT has two 8259 interrupt controllers, so it can control up to 16 interrupt 
sources. The interrupts in the second controller have designations ranging from 
IRQ8 to IRQIS. If an interrupt request is made from one of the eight interrupt 
sources of the second interrupt controller, it simulates the request fron a device 
connected to bit 2 of the first interrupt controllers. Because of this, all interrupt 
requests from the second interrupt controller have a higher priority than those from 
devices 4 to 7 of the first interrupt controllers. If several devices demand attention 
from the second interrupt controller, it services the interrupt source with the 
highest priority, which is the one connected to the lowest bit in the interrupt mask 
register. 


Interrupt requests from the devices on the second interrupt controller can be 
suppressed by manipulating the corresponding bits in the interrupt mask register. 
This register is located at port address A1H, not at 21H like the first interrupt 
controller. The interrupt instruction register of the second interrupt controller, to 
which the EOI instruction must be sent after the completion of the interrupt from 
this controller, is at address AOH instead of 20H. In addition to the EOI instruction 
to the second interrupt controller, an EOI instruction must be sent to the first 
interrupt controller on port 20H at the end of the interrupt routine. This results 
from the interconnection between these two controllers, since every interrupt 
request to the second interrupt controller triggers an interrupt request on the first 
interrupt controller. 
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The following figures show the interrupt request devices and their priorities. 


PC 
decreasing priority 


7 6 4 3 


5 2 


i 0 bit } 

Tr 
| at port 20(h) 

| [timer 


“1 2nd | 
1st serial interface 


Floppy disk 
i 


Interrupt requests and priorities (PC) 


XT 
decreasing priority 
7 6 5 4 3 2 1 0 pit _—_ 
Ptr ddd ll _| Interrupt controller] 
| LE at port 20(h) | 


| Timer 


Keyboard | | 


2nd serial interface | 
1St | 


| Hard disk | | 
Floppy disk _ | 
Parallel printer 


Interrupt requests and priorities (XT) 
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AT 


decreasing priority 
Se 
0 bit 


7 
interrupt controller 
Ly LEU, af 


Serial interiace [Timer | 
Keyboard : 
Paraicl ¢ aor bit 


Hard disk 
Realtime clock 


decreasing priority 
-————_—_—___——_—__—— 


Interrupt requests and priorities (AT) 


Interrupt O8H: Timer 


The PC's 8253 timer chip oscillates at 1,193,180 cycles per second. It receives its 
signal from the 8284A clock generator chip. After 65,536 of these signals (about 
18.2 cycles per second), it calls interrupt 08H, which the 8259 transmits to the 
CPU. Since the occurrence of these interrupt calls is independent of the clock 
frequency, this interrupt works well for time measurement. After 18.2 calls means 
that a second has elapsed. BIOS points the interrupt vector of this interrupt to its 
own routine, which is called 18.2 times per second. The routine increments the 
time counter at every call and switches off the disk motor if no access to the disk 
has occurred within a certain span of time. After this task has been completed, the 
routine calls interrupt 1CH. It can be accessed by the user for routines which 
depend upon a continuous signal. 


Interrupt O9H: Keyboard 


The keyboard has either an Intel 8048 processor (for PC/XT) or an 8042 processor 
(for AT). It controls the keyboard and registers if a key was pressed, released or 
pressed and held. The keyboard chip sends a signal to the 8259, which causes the 
CPU to call interrupt 09H (unless an interrupt request with a higher priority is 
present). The CPU calls a BIOS routine which reads the character from the 
keyboard and stores it in the keyboard buffer. 
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Interrupts OAH—OCH: Various 


These interrupts vary with the hardware connected to the computer. Check your 
technical manuals and hardware manuals for more information, and experiment. 


Interrupt ODH: Hard disk 


The system calls interrupt ODH if a hard disk is connected to the computer. This 
occurs when a read or write operation ends and BIOS must be informed of this fact. 


Interrupt OEH: Disk 


The disk controller(s) calls this interrupt in conjunction with the 8259 when the 
controller needs the attention of the CPU. A BIOS routine following this interrupt 
communicates on the lowest level with the controller. During the call of this 
interrupt, the controller passes certain information to inform BIOS that a read or 
write operation was completed, or an error occurred. 


Interrupt OFH: Printer 


A parallel printer calls this interrupt in conjunction with the 8259 when the 
controller needs the attention of the CPU. 


AT interrupts 


Because of the second interrupt controller in the AT, it has more hardware 
interrupts than the PC or XT. This second interrupt controller can call interrupts 
70H to 77H. These interrupts were available to older PCs for application 
programs. Recently manufactured PCs and XTs cannot use these interrupts. 
Similar to the first interrupt controller, the device connected with bit 0 of the 
second interrupt controller's interrupt mask triggers interrupt 70H. The device on 
bit 1 calls interrupt 71H, bit 2 calls interrupt 72H, etc. 


Only interrupts 70H and 75H are called by the interrupt controller because devices 
are only connected to bits 0 and 5 of the interrupt mask register. However, the 
interrupt vectors of interrupts 71H to 74H and 76H and 77H should not be 
redirected. 

Interrupt 70H: Realtime clock 
Interrupt 70H can stop a program because of alarm time, the current time and date, 
or just an interrupt call repeated within a certain time span. The interrupt is 


normally serviced by a BIOS routine which detects the reason for the interrupt then 
responds accordingly. 
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Interrupt 75H: Math coprocessor 


Interrupt 75H informs the AT's CPU that a mathematical coprocessor (80287) 
attached to the system requires attention (e.g., because it has completed a certain 
calculation). 


Interrupt 76H: AT hard disk 


The AT hard disk controller calls this interrupt after completing a hard disk access. 


Demonstration programs 


Clock 


The two sample programs below demonstrate some of the hardware interrupts 
described in this chapter. Both programs are resident interrupt drivers which are 
installed and deactivated using the same principles as demonstrated by programs 
earlier in this book. 


The first program displays the current time in the upper right corner of the display 
screen. The second program sends the contents of a screen to a file instead of a 
printer. 


timing 


Before discussing each program's structure, you should know about the basic 
principles of the clock. Interrupt 1CH implements the clock. Timer interrupt 8H 
calls interrupt 1CH 18.2 times per second. 


When this routine counts the number of calls that occur, it knows that exactly one 
second elapses after 18.2 calls, and that it must display the time on the screen once 
every second. This is great, except that the clock can count one, two, even 18 
calls—but not 18.2 calls. 


One solution would be to have the clock update the screen display after 18 
interrupt calls. This would result in the clock running fifteen minutes fast every 
day. You can solve this problem using a trick that we use in everyday living. Our 
year doesn't have exactly 365 days. Every four years the calender has a leap year, 
which keeps our dates on schedule with Earth's realtime clock. 


' The PERMCLK program does something similar with the clock. After 18 calls of 


the timer interrupt routine, the clock advances one second and the new time appears 
on the screen. Therefore, the time advances by five seconds after 5x18 (90) calls. 
Five seconds in reality equals 5x18.2 (91) calls. To compensate for the missing 
call, the program adds a sixth second after 19 calls. This makes the time 
measurement more accurate. Since a second actually corresponds to 18.20648193 
calls, the clock will still be fast by a few seconds after a day passes. To 
compensate for this, an additional second is introduced after 20 calls. This makes 
the clock only about a second fast within a 24-hour period. That's fairly accurate, 
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especially when you consider that the average PC doesn't remain switched on for 


more than eight hours at a time. 


FARRER RERERREKEER HERRERA HAEEERREKEKRKIAREEEEEREEEEEKRHEKEEKKE 9 
;* PERMCLK *; 
on ‘sens mmm css cs te si ein smi epi Sn mn ci wuss em ie i isi Sin is ms sims ee coms nous eptember sus i is a ams ps sm mem emis eee *s 
:* Task : displays the current time on the ae 
* display Screen it 
e* ‘ccs ies cists ce ui ems cb esi ds Ss ces au cs ns Geo mmc emis el mss Ces en eed hbo a i seem sn usenet re Gs soem coma cs Sou euceecin'ci hi eh annsas ta tbs ba 
PEs Author : MICHAEL TISCHER 9 
7* developed on : 8.10.87 *3 
7* last Update : 9.21.87 x 
I ace cos ens ces cis sain ius Seas na ens cs ‘ss as won usec wes chars ac ects es tn cess Ces ees is sc os mes es i mach Gen wines cng es chy ea ecient com aes ks cae isc a ei cis i a i ca, i ci eo ke 
v v 
tie! assembly : MASM PERMCLK; “3 
= LINK PERMCLK; sy 
rad EXE2BIN PERMCLK PERMCLK.COM *s 

I a a i ae aes ceca eos carmen Seas ces ss Sckn e ass oes Mee ces Wels ie tes tems ies eas us ns ea a See it Ca is cs Mis sims ins etme al ech ces en's ch cn ems clus Gas sem Se ech cs Ss Gas nes tai ha wa ab Cc tke 
o v 
7? Call : PERMCLK = 
FREAK KR ERK KEKE KER EEE KEKE KEK KEK KEKE EERE KEKEKKEKKKEKRKKKEKKREKKKEKEKEKKEKEKE 9 


CLKCOLUMN = 72 
CLKLINE = 0 
CLKNUM = 6 
CLKCOLOR = 70h 


gline and column in which the time 
zis displayed 


scolor of the clock: inverted 


*== here starts the actual Program ===22==s====s=s=2==22=2==se==s=ss=s2=== 
; g 


code 


start: 


segment para 'CODE' ;Definition of the CODE-segment 
org 100h 
assume cs:code, ds:code, es:code, ss:code 


jmp perminit 7Call of the initialization routine 


alterint 


intaltofs 
intaltseg 


time 
tenhours 
onehour 


tenmint 
onemin 


tensecs 
onesec 


tcount 
numcount 
countl 
count2 


newint 


newtimer: push ax 


equ this dword 7;old interrupt vector 1CH 


dw (?) Offset address interrupt vector 1CH 
dw (?) z;segment address interrupt vector 1CH 
equ this byte yaccepts the current time 
db (?) 710 hours as ASCII 
db (?) 7one hours as ASCII 
db dy 
db (?) zten minutes as ASCII 
db (?) zone minutes as ASCII 
db “;" 
db (?) zten seconds as ASCII 
db ({?) 7One seconds as ASCII 
db 18 ;decremented on every timer-call 
db CLKNUM ¢display counter for clock 
db 5 ;correction counter 1 
db 31 scorrection counter 2 


proc far 
jmp short newtimer 
db “JsS" zIdentification of the program 


srecord all registers which are changed 


PC System Programming 


gafter how many 1/18 S. is the clock displayed 
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push bx 
push cx 
push dx 
push di 
push si 
push es 
push ds 


push cs 
pop ds 


dec numcount 
jne nonum 


mov numcount, CLKNUM 


nonum: dec tcount 
je nextsec 
emp numcount, 255 
jne stl 
jmp restore 


nextsec: mov tcount,18 
dec countl 
jne settime 
mov countl1,5 
inc tcount 
dec count2 


jne settime 
mov count 2,31 
inc tcount 


settime: inc onesec 
cmp onesec,":" 
stl: jJne output 
mov onesec, “0" 
inc tensecs 
cmp tensecs, "6" 
jne output 
mov tensecs, “0" 
inc onemin 
cmp onemin,":" 
jne output 
mov onemin, "0" 
inc tenmint 
cmp tenmint, "6" 
jne output 
mov tenmint, "0" 
inc onehour 
cmp onehour, “:" 
jne test24 
mov onehour, "0" 
inc tenhours 
jmp short output 


test 24; cmp cnehour, “4" 
jJne output 
cmp tenhours, "2" 
jne output 
mov tenhours,“0“ 
mov onehour,“0" 


output: mov ah,15 


int 10h 
mov ah,3 
int 10h 


push dx 
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zby the program 


gstore CS on the stack 
j;return as DS 


sdecrement counter for display 
snot yet zero 


zset to original value 


jalready called 18 times ? 
7;YES --> one Second passed 
7;display clock now ? 

7NO ==> output 

7YES --> back 


z;set Call-counter new 


;correction-counterl dec. 5 times 


7NO --> increment ASCII-time 
7;YES --> set to 5 again 
sincrement Call-counter 
;correction-counter2 
;decremented 31 times? 

7;NO --> increment ASCII-time 
7YES --> set again to 31 
zincrement Call-counter 


;increment one second (ASCII) 
zone second = 10? 

7;NO --> output time 

z;set one second to zero 
;increment ten second (ASCII) 
;ten second = 6 (60 Seconds)? 
7;NO --> output time 

;set ten seconds to zero 
;increment one minute (ASCII) 
yone minute = 10? 

7NO --> output time 

z;set one minute to zero 
zincrement ten minute (ASCII) 
z;ten minute = 6 (60 Minutes) 
7NO --> output time 

;set ten minute to zero 
s;increment one hour (ASCII) 
7one hour = 10? 

;NO --> test 24 hour 

7;YES --> set one hour to zero 
gincrement ten hour (ASCII) 


zone hour = 4? 

7;NO --> output time 
7;YES --> ten hour = 2? 
7;NO --> output time 

7a new day started 


;read current display page 
7call BIOS video-interrupt 
;read current cursor-position 
7call BIOS video-interrupt 
pstore on stack 
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mov si,offset time zoffset address of the time-string 

mov cx,l gwrite each character once 

mov dx,CLKLINE shl 8 + CLKCOLUMN ;cursor-position for time 

mov bi, CLKCOLOR gcolor of the clock 

mov di,8 78 characters are output 
pritime: mov ah,2 ;set cursor-position 

int 10h ;call BIOS video-interrupt 

mov dh,CLKLINE shl 8 ;repeat line 

inc dl ;increase column for next character 

mov ah,9 youtput a character 

lodsb sget character from the string 

int 10h 7call BIOS video-interrupt 

dec di gall characters processed ? 

jne pritime ;NO --> output next character 

pop dx zget old cursor-position 

mov ah,2 zand set again 

int 10h 7call BIOS video-interrupt 
restore: pop ds ;restore all recorded registers 

pop es yagain 

pop si 

pop di 

pop dx 

pop cx 

pop bx 

pop ax . 

jmp cs:(alterint] ;jump to old timer-Interrupt 
newint endp 
instend equ this byte 7;if SHOWCL is installed, memory 


;can be released from here on 
z7== Data (can be overwritten by DOS socsaseesessesssseessse= 
installm db 13,10,"PERMCLK (c) 1987 by Michael Tischer",13,10,13,10 
db “PERMCLK was installed and can be deactivated ",13,10 
db “through a new Call",13,10,"$" 
deactmsg db "PERMCLK was deactivated “,13,10,"$" 


7-~ Start and Initialization Routine ----------------------------- 


perminit proc near 


mov ax,351Ch 7get content of interrupt vector 1C 
int 21h 7;call DOS-function 

cmp word ptr es: [bx+2],"SJ" stest if PERMCLK 

jne install znot yet installed --> install 


7~- PERMCLK deactivated again ----~~---------------------- 


mov dx,es:intaltofs 7offset address of interrupt 1CH 
mov ax,es:zintaltseg ;segment address of interrupt 1CH 
mov ds,ax zto DS 

mov ax, 251Ch sreturn content of the interrupt 
int 21h s;vector 1CH to old routine 

mov ah,49h z;release the storage of old 

int 2ih 7;PERMCLK again 

push cs 7;store CS on the stack 

pop ds ;return as DS 


mov dx,offset deactmsg ;message: program removed 
mov ah,9 youtput function number for string 
int 2ih 7;call DOS function 
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mov ax, 4Cc00h ;code for program executed correctly 
int 21h zend program with end-code 


g-~ Install PERMCLK —--—=<<—=+-=225=<=4-<<3=-<----=--3-—— 


install: mov intaltseg,es ;segment and offset address of the 
mov intaltofs,bx zinterrupt vector 1CH 
mov ah,02Ch zread function number for time 
int O21h ;call DOS interrupt 21H 
mov al,cl ;transmit minute to AL 
mov di,coffset tenmint sASCII result to TENMINT 
call binascii zconvert 2 numbers to ASCII 
mov al,ch stransmit hour to AL 
mov di,offset tenhours ;ASCII result to TENHOURS 
call binascit sconvert 2 numbers to ASCII 
mov al,dh ;transmit seconds to AL 
mov di,offset tensecs s;ASCII result to TENSECS 
call binascii sconvert 2 numbers to ASCII 


mov dx,offset newint ;offset address new interrupt-routine 
mov ax,251Ch ;point content of the interrupt 
int 21h svector 1C to user routine 


mov dx,offset installm ;message: program installed 
mov ah,9 soutput function number for string 
int 21h ;call DOS-function 


7-- only the PSP, the new interrupt-routine and the -------- 
;-- Data for it, must remain resident 


mov dx,offset instend ;calculate the number of 


mov cl,4 ;paragraphs (each 16 Bytes) which 
shr dx,cl ;the program has available 

inc dx 

mov ax,3100h 7end program with end-code 0 (0.k) 
int 21h ;but remain resident 


perminit endp 


7-~ BINASCII : convert binary-value into 2-digit ASCII ---------------- 
7—7~ Input : AL = the binary-value to be converted 

j-- DI = the offset address for the 2 ASCII numbers 

7-—- Output : none 

7-- Register : AX, CL and FLAGS are changed 


binascii proc near 


xor ah,ah 7HI-Byte for division = 0 
mov cl,10 7;decimal system is used 
div cl ;divide value by 10 

or ax,03030H ;convert result into ASCII 
mov [di],ax zand store 

ret ;back to caller 


binascii endp 


code ends 7end of the CODE-segment 


Installation and reinstallation has similarities to the resident interrupt driver already 
discussed. It installs itself during its first call and deactivates itself on the 
following call. 
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The code following the INSTALL label initializes all the program's variables. 
First the DOS function 2CH reads in the current time, converts the time into 
ASCII code and places the data in the variables TENHOURS, TENMINT and 
TENSECS. These variables, which are part of an ASCII string, act as buffers for 
the time display and are updated once every second. After these variables have been 
initialized, the program installation takes place. 


Let's look at the clock itself, the new interrupt routine of interrupt 1CH. It begins 
in the listing at the label NEWINT. It jumps to the label NEWTIMER to bypass 
the identification code. All registers changed by the following commands are stored 
on the stack. Then the counter (the variable) NUMCOUNT is decremented. 
NUMCOUNT has nothing to do with time measurement; it determines how often 
to display the time on the screen. Normally the clock must be redisplayed when 
the time has changed (every second). Since the screen scrolls in some applications 
(e.g., DOS), the clock would quickly disappear from the display. To display a 
Clock that looks stationary, it must be redisplayed more often than once a second. 


When NUMCOUNT reaches the value 0, this means that the clock display 
reappears with the following commands, even if a new second hasn’t occurred. 
After NUMCOUNT reaches zero, it resets to its original value so that it can be 
decremented again the next time the routine is called. The constant CLOCKNUM 
contains the original value (6), which displays the clock after 6/18 second (one- 
third of a second). You may preset other values to display the clock more or less 
often. 


At the label NONUM the counter TCOUNT decrements. It contains the number of 
remaining calls until a second has elapsed. If the number is equal to zero, a second 
has elapsed and a jump occurs to the label NEXTSEC where it resets to 18 so that 
the next second can be displayed after 18 calls. 


If a second hasn’t elapsed, the program tests for whether the variable NUMCOUNT 
reached zero and resets to its starting value during this call of the timer interrupt. If 
this was the case, the time appears on the screen and the interrupt ends. If the time 
isn't displayed, the interrupt can be ended directly. 


After NEXTSEC resets TCOUNT to 18, the first correction counter decrements. If 
it is equal to zero, it means that five seconds have elapsed and that the next second 
can only be initiated after 19 calls. The TCOUNT counter increases from 18 to 19 
and the first correction counter resets to five. Then the second correction counter 
decrements. If it then contains the value zero, then 31x5 seconds have passed and 
the next second can only be initiated after 20 calls. 


At the label SETTIME, incrementing the least significant digit of seconds (one) in 
the variable ONEMIN sets the new time. A test is made for the start of a new 
minute, a new hour or a new day; the time changes accordingly. 
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The label OUTPUT begins the actual time display. OUTPUT reads the current 
display page and cursor position. This data passes to the stack so it can be restored 
after the time is displayed on the screen. The cursor moves into position and the 
program displays the clock, character by character. 


In the final step, the previously stored current cursor position is removed from the 
stack and set. This occurs through a function of the BIOS video interrupt. 


This concludes the work of the timer routine. It restores the registers from the 
stack, passing them unchanged to the interrupted program. It finally ends with a 
jump to the old timer routine. 


The HC2FILE program 


The second sample program in this chapter reroutes hardcopy data to a file instead 
of a printer. The program requires the entry of the program name and the path and 
name of the hardcopy file. This name can contain a device and path designation, 
but must have a three digit number as an extension (e.g., 000 or 153). A sample 
call would look like this from the DOS prompt: 


Cohe2file a:zhc.001 


You would then press <Shift><Prt Sc> as you would for a printed screen 
hardcopy. To capture hardcopies in sequence, the number in the file extension 
automatically increments after the creation of every hardcopy file. For example, the 
first hardcopy goes to a file named HC.001 and a second hardcopy would go to a 
file named HC.002. During output the individual characters are read from the 
current display page, but their colors (an attribute) are not stored. The screen lines 
in the file write to disk in sequence (no carriage returns separate lines). You can 
view this file on the screen using the DOS TYPE command. 


The program expects a filename during the first call from the DOS level. If you 
omit the filename, the HC2FILE program will not be installed. If you call the 
program again after its installation without passing a filename, it deactivates the 
installed hardcopy program and releases the memory it occupied. If the program is 
called again with a filename after a successful installation, the installed hardcopy 
program remains active, and the new name for the hardcopy file takes effect. 


Perhaps the new hardcopy interrupt routine may be of interest. You call it after 
installation by pressing <Shift> <Prt Sc>. 


First it determines the number of the current display page and the current cursor 
position using a function of the BIOS video interrupt. It stores these on the stack, 
returning them to BIOS after the output of the hard copy. Then it opens the file 
which is to receive the hard copy. An error message is output if the attempt fails. 
In the next step the display screen content is read line for line into a buffer 
(starting at the beginning of the PSP) and is written from there to a file. Here also 
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an error message is output through DOS if an error is reported and the file is 
erased. 


If the hardcopy could be output successfully, the file is closed and the extension of 
the filename (the number of the hardcopy) is incremented. Once the number 1,000 
is reached, the numbering restarts at 0. 


Warning: 
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An important restriction during the use of this program must be observed. It can 
only be called when no access is made simultaneously by DOS to the disk or hard 
disk. If the new hardcopy is called during the DOS access, most systems will crash 
because DOS is not capable of controlling several file or disk accesses 
simultaneously. DOS is not re-entrant. Remember this limitation when using this 
routine, because it cannot be bypassed. 
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Task : Outputs the Hardcopy of an 80-column-text bf 
screen in a file instead of the printer. * 

The file must have a three digit number * 

as extension which is incremented after * 
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the output of the hard copy so that several 
hard copy files can be created in succession 
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WARNING : after installation of this program 
no hard copy may be called during 
a disk or hard disk access. 
The system will crash since DOS is not 
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* Author : MICHAEL TISCHER *; 
* developed on : 8.11.87 <7 
* last Update : 9.21.87 ae) 
a xs 
* assembly : MASM HC2FILE; sai 
* LINK HC2FILE; *? 
* EXE2BIN HC2FILE HC2FILE.COM igh 
Fe ce ne ce er ee ee a nse ee i ce ce ma Sn oe ene oe ene NS eee ae nS eh DS an oY ne Gee ee Sse a cr ke ee ee ee Ke 
* Call : HC2FILE [(Dr:) (Path)Filename.zzz] xs 
fp RKKRKRHRK EKER KEKE KKK KKK KK ERK HK KKEK HER ARKERK KEKE KER AKKKEKEKEKKKKEKKKKKHKE 9 


= 


== here starts the actual Program SSS SS SS SSS SSS SSS SS Se SS eS SS 
code segment para 'CODE' ;definition of the CODE-segment 
org 100h 


assume cs:code, ds:code, es:code, ss:code 


start: jmp heinit 7Call of the initialization-routine 

;,== Data (remain in storage) exes Sees SSS es SSS SS ss SSS SSS ST 

alterint equ this dword 70ld Interrupt vector 05H 

intaltofs dw (?) 70ffset address Interrupt vector 05H 

intaltseg dw (?) ;segment address Interrupt vector 05H 
print db 0 zindicates if printing is in progress 
handle dw (?) zkey for access to File 

hcerr db “HC2FILE: Error on output of the hard copy",13,10,"S$" 
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7== this is the new hard copy interrupt (remains in memory ) ========c= 


newint 


newhc: 


dohc: 


nextline: 


error: 


datclose: 


proc 


jmp short newhc 


far 


db “RL" 


sti 


cmp cs:print,0 
je dohc 
jmp newhcend 


MOV 
push 
push 
push 
push 
push 
push 
push 
push 


mov 
mov 
mov 
cld 


mov 
int 
mov 
int 
push 


mov 
xor 
mov 
int 


Jc 


mov dx,offset hcerr 


Mov 
int 


jmp 


cs:print,1 
ax 
bx 


ax, cs 
ds, ax 
es,ax 


ah,15 
10h 
ah, 3 
10h 
ax 


ah, 3Ch 
Cx, CX 
dx, 130 
21h 

error 


handle, ax 


bl,-1 

bl 

b1,25 
datclose 
hcline 
next line 


ah, 3Eh 
bx, handle 
2ih 

ah, 41h 
ax, 130 
21h 


ah, 9 
21h 


short restore 


sIdentification of the program 


zinterrupts are again permitted 
sprinting in progress? 

7NO --> print out 

7YES --> do not output hard copy 


7print now 
;save all registers which are changed 


;bring CS to AX 
z;and then set DS and ES 


7on string commands count up 


;read current display page 
;call BIOS video-interrupt 
;read current cursor-position 
7;call BIOS video-interrupt 
;store on the stack 


;create function number for file 
z;should become normal file 
;filename at DS:130 

7call DOS-interrupt 21H 
;carry-flag set --> Error 


ssave handle of the file 


zbegin with line 0 
zincrement line number 
;all lines printed ? 
7;YES --> close file 

7;NO --> output a line 
;no error --> next line 


;close function nr. for file 
paccess-key 

3;call DOS-interrupt 21H 
yerase function nr. for file 
;filename at DS:130 

7call DOS-interrupt 21H 


7error message offset address 
voutput function nr. for string 
7call DOS-interrupt 21H 


;-- all lines output successfully ----------------------- 


ah, 3Eh 
bx, handle 
21h 
error 


bx, 128 


;close function nr. for file 
7 access~key 

7;call DOS-interrupt 21H 

not closed --> Error 


z;address of number of command line 


683 


restore; 


newhcend: 


newint 


- Input 


LA 


endp 


y;—7~ HCLINE : 


77~ Output 


hcline 


getc: 


hcline 


instend 


; Register : 
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bl, [bx] 
bl1,128 
bh, bh 
byte ptr 
byte ptr 
restore 
byte ptr 
byte ptr 
byte ptr 
restore 
byte ptr 
byte ptr 
byte ptr 
restore 
byte ptr 


ax 
ah, 2 
10h 


Write a display line into the file 


{bx ] 
{[bx],“:" 


[bx] ,"0" 
{bx-1] 
{bx-1]," 
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gnumber of characters in command line 
zcalculate character end address 
;Hi-Byte of the address is 0 
zincrement last number 
;reached ten ? 
7;NO --> RESTORE 
;set one number back to 0 
zincrement ten number 

:";has hundred been reached? 
7;NO --> RESTORE 


[bx-1],"O";ten numbers set back to 0 


(bx-2] 
(bx-2]," 


sincrement number 
:"shas one thousand been reached? 
sNO --> RESTORE 


[bx-2],"O"zwhole number is again 0 


sget old cursor-position 
zand set again 
;call BIOS video-interrupt 


shard copy output finished 
;restore all stored registers 


zback to keyboard routine 


BL = the number of the line 

BH = the number of the display page 
Carry-flag = 1 : Error 

AX, CX, DX, SI, DI and FLAGS are changed 


proc near 
push bx 
xor di,di 
xor dl,dl 
mov si, 80 
mov ah, 2 
mov dh,bl 
int 10h 
mov ah,8 
int 10h 
stosb 
inc dl 
dec si 
jne getc 
mov ah,40h 
mov bx, handle 
mov. cx, 80 
xor dx,dx 
int 2ih 
pop bx 
ret 
endp 


equ this byte 


;store BX on the stack 


;copy at start of PSP 
estart with column 0 
sprocess 80 columns 


;set function number for cursor 
display line to DH 

7;call BIOS video-interrupt 

zread function number for character 
7call BIOS video-interrupt 

;store character in the buffer 
;increment column 

7all column processed? 

7NO --> get next character 


;function nr. for writing 

gaccess key 

7every line has 80 bytes 

;offset address of the buffer is 0 
7call DOS-interrupt 21H 


y;restore BX 
zback to caller 


zif HC2FILE is installed, the memory 
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;can be released starting here 


installm 


deactmsg 
ninstall 
newnam 


FEEEEEEEE 


13,10,"HC2FILE (c) 1987 by Michael Tischer",13,10,10 
“HC2FILE was installed and can be “,13,10 

“deactivated with a new cal] (without parameter) ",13,10 
“A new call with parameters changes the ",13,10 

“Name of the file to which hardcopy is output.",13,10,"$" 
“HC2FILE was deactivated", 13,10, "S$" 

“HC2FILE was not yet installed",13,10,"$" 

“HC2FILE was already installed, only filename " 

“was changed", 13,10, "$" 


7== Program (can be overwritten by DOS) =s]«25=2=sussssssse==c== 


z-- Start and Initialization-Routine 


heinit 


away: 


hcfend: 
hefend1: 


install: 


proc 


7-~ was already installed, change only filename 


near 


si,128 

byte ptr [si],0 
ax, 3505h 

21h 

install 


gaddress of the command line in PSP 
;was parameter passed 

zget content of interrupt vector 5 
;call DOS-function (flags remain) 
7NO --> install program 


HC2FILE deactivate again -—----------------~------------ 


word ptr es: [bx+2],"LR“ ;test if HC2FILE 


away 


dx, offset ninstall 


al,l 
short hcfend1 


dx,es:intaltofs 
ax,es:intaltseg 
ds, ax 

ax, 2505h 

21h 


dx,offset deactmsg 


al,al 
ah,9 
21h 
ah, 4Ch 
21h 


install HC2FILE 


7YES --> remove again 


ywas not yet installed 
7end-code: error 
;terminate program 


;offset address of interrupt 5 
7;segment address of interrupt 5 
zto DS 

;set content of the interrupt 
;vector 5 to old routine again 


;release the memory of old 
;HC2FILE again 


zstore CS on the stack 

;restore DS 

;mMessage: program removed 
7end-code: everything o.k. 

poutput function number for string 
3;call DOS-function 

;function nr. for prg.termination 
7end program with end-code 


word ptr es: [bx+2],"LR“ ;test if HC2FILE 


newinst 


mov cl, [si] 

inc cl 

xor ch,ch 

mov di,128 

cld 

rep movsb 

xor al,al 

stosb 

mov dx,offset newnam 


7;NO --> first installation 


snumber of characters in command line 


zalso the number of characters 
7erase HI-Byte 

7also ES:DI, but in old HC2FILE 
70n string commands count up 
;copy filename in PSP 

70f the old HC2FILE 

7;NUL terminates the filename 
;store in PSP of the old HC2FILE 
;offset address of the message 
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jmp 


newinst: mov 
mov 


short hcfend 
intaltseg,es 
intaltofs, bx 

bl, [si] 

b1,129 

bh, bh 

byte ptr [bx],0 
dx,offset newint 
ax, 2505h 

21h 

dx,offset installm 
ah, 9 

21h 
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zterminate program 


;store segment and offset 
gaddress of interrupt vector 05H 


znumber of characters in command line 
;calculate end addr. of character 
;Hi-Byte of the address is 0 

;set NUL behind the file name 


soffset address new interrupt-routine 
;deflect content of the interrupt 
;vector 5 to user routine 


;message: program installed 
soutput function number for string 
3;call DOS-function 


only the PSP, the new interrupt-routine and the --------- 
Data pertaining to it must remain resident. 


dx,offset instend 


ax, 3100h 
2ih 


heinit endp 


;calculate number of paragraphs 
3 (each 16 Bytes) available to 
;the Program 


zend program with end-code 0 (0.k) 
sbut remain resident 


code ends 


end 


start 


7End of the CODE-segment 


Chapter 17 


Hard Disk Partitioning 


FDISK is the hard disk partitioning program available in MS-DOS. You probably 
used the FDISK command if you installed your own hard drive, or if you've 
enhanced a PC with an operating system such as XENIX, CP/M-86 or OS/2. 
FDISK is the key to operating high capacity hard disks and to installing multiple 
operating systems on one computer. 


FDISK represents only one step of a three step formatting process. This process 
formats and partitions a hard disk drive, preparing it for one or more operating 
systems. 


Low level formatting 


The first step, called low level formatting, divides the hard disk into cylinders 
(tracks) and sectors. This division writes corresponding address markers on the hard 
disk. Low level formatting is required, since many hard disk units come from the 
manufacturer unformatted, like floppy disks. 


Some XT-compatible PCs had to be low level formatted using the DEBUG 
program. DEBUG called the low level format routine from the hard disk 
controller's ROM-BIOS. Most hard disk manufacturers now provide programs 
which make the low level formatting process much simpler. 


Partitioning 


The next step in formatting the hard disk is partitioning. As the name suggests, 
this process divides the hard disk into definite regions. The original purpose of 
partitioning was to divide hard disks into areas which could be occupied by 
different operating systems, without the operating systems conflicting with one 
another. 


The drop in hardware prices in the late 1980s provided another reason for 
partitioning. Hard disks became available at low prices with capacities of 40 
megabytes and more. 
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This posed a problem. Versions of DOS below Version 3.3 could only support a 
maximum of 32 megabytes per hard disk. In addition, earlier versions of DOS 
couldn't partition hard disks into several units. 


DOS version 3.3 


DOS 


6388 


Version 3.3 of DOS still limited hard disk access to a maximum of 32 megabytes, 
but offered some alternatives to the user. DOS 3.3 allowed the configuration of a 
primary partition in the first 32 megabytes of the hard disk, as well as 23 
additional extended partitions using drive specifiers of D to Z. Since every extended 
partition can have up to 32 megabytes, this partitioning increased the maximum 
hard disk capacity to 768 megabytes. FDISK names these partitions PRI DOS and 
EXT DOS. 


version 4.0 


DOS version 4.0 permits mass storage device support up to 2 gigabytes, thanks to 
revised device drivers. However, many users still prefer partitioning their hard disk 
unit into logical hard disks (smaller drives), since file management is easier on the 
logical drives than having hundreds of files on one drive. 


FDISK creates a special sector called the partition sector which it places on the 
first hard disk sector (head 0, cylinder 0, sector 1). BIOS loads this partition sector 
into memory address 0000:7CO00, unless the user has placed a disk in drive A: 
before power-up or reset. If the computer finds the code sequence 55H, AAH in the 
last two bytes of this 512-byte sector, it treats this sector as executable and starts 
program execution with the first byte of the sector. Otherwise, BIOS displays an 
error message and either starts an infinite loop or starts ROM BASIC, depending 
on the manufacturer and version of the system. 


Length: 200H (512) bytes 


The program code in the boot sector recognizes the active partition and the 
operating system to be started. The boot sector and the required operating system 
code loads and executes. Since this program code by definition must also be at 
memory address 0000:7C00, the parvition code moves to memory address 
0000:0600 and releases the memory for the boot sector. 
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The routine obtains the location of the boot sector to be loaded from the hard disk, 
and the boot sector's corresponding partition. The partition table located in the 
partition sector at address 1BEH contains this information. 


Partition table entry layout 


Addr. 


+00H Partition status 1 byte 

OOH = inactive 

80H = boot partition 

+01H Read/write head where partition starts 

+02H Sector and cylinder where partition starts 

Partition type 

OOH = entry not occupied 

O1H = DOS with 12-bit FAT (primary partition) 

O2H = XENIX 

O3H = XENIX 

04H DOS with 16-bit FAT (primary partition) 

O5H extended DOS-Partition (after DOS 3.3) 

O6H = DOS-4.0 partition with more than 32 meg 

DBH = Concurrent DOS 

Other codes possible in conjunction with other 
berating systems or special driver software 

+05H Read/write head at end of partition 1 byte 

+06H Sector and cylinder at end of partition 1 word 

+08H Distance of first sector of the partition 1 dword 

(boot sector) from partition sector 

(measured in sectors) 


+O0CH Number of sectors in this partition 
Length: 10H (16) bytes 


es 
io) 
N= 
se) 


Every partition is described within this table through a 16-byte structure. Since the 
table is almost at the end of the partition sector, there is only room available for 
four entries. This limits the number of partitions to four. To provide more 
partitions on a hard disk, some manufacturers offer a special configuration program 
which moves the table ahead within the partition sector and installs new partition 
code which accesses the reconfigured table. The basic format of the table remains 
unchanged. Remember that individual partition entries do not always start with the 
first table entry. The partition of a hard disk can be described through the first, 
second, third or even fourth table entry. 


The boot partition can be recognized through the first field of the partition 
structure. The value OOH stands for "inactive," while the value 80H indicates the 
partition for booting. If the partition code detects no bootable partition, more than 
one partition, or even unknown code during the table check, the booting process 
terminates and the system goes into an endless loop. The only alternative is to 
reset the system. 


If the partition code recognizes the partition to be booted, it can determine the 
position of this partition on the hard disk through the two following bits. The 
sector and cylinder number are coded in the form compatible with BIOS interrupt 
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13H (disk/hard disk). Bits 6 and 7 of the sector number represent bits 8 and 9 of 
the cylinder number. Interrupt 13H and its functions are the only means of 
accessing the hard drive. DOS functions are unavailable until after the system 
boots DOS. 


Even though this information is enough to load the boot sector of the starting 
partition, the partition table contains some additional information which is 
important for later changes and additions. The position of the boot sector is 
followed by a field which describes the type of operating system hidden behind the 
partition. 


Besides the starting sector, the ending sector of the partition is indicated in the 
partition sector. The position of this sector is again described through an indication 
of the head, cylinder and sector numbers. The last two fields of a table entry 
contain the number of sectors within the partition, the distance of the boot sector 
of the partition from the partition sector, as counted in sectors. 


When the partition table is checked, it usually determines that the first partition 
Starts with sector one, track zero of the second read/write head, instead of 
immediately following the partition sector. This wastes almost all of track one of 
the first read/write head, almost the complete first track of the first head is wasted, 
not counting the partition sector in the first sector of this track. 


The extended DOS partitions suffer from some inconsistencies. First of all, DOS 
Version 3.3 allows only one extended partition on a hard disk, other than the 
primary partition. FDISK provides the extended partition with a partition sector 
containing a partition table instead of program code. This table consists of two 
entries: 


1.) A description of the extended partition proper, along with a partition type 
value of either 1 (DOS partition with 12-bit FAT) or 4 (DOS partition 
with 16-bit FAT) 


2.) A description of the next extended DOS partition, if one is present. 


Any additional extended partitions are preceded by partition sectors, as described 
above. This creates a chained list which ends only when the partition type field 
within the partition sector contains the value 0. 


The following programs in Pascal and C display the contents of the partition 
sector, and follow the partition sectors of any extended partitions. 
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Pascal program: FIXPARTP.PAS 


{HR IH IK IH HHI IRR RI RII KIRK KIKI KI KIKI KIARA KRHA AIARKERAEEEREEKEE | 


{* FIXPARTP.PAS a 
{* a a ee a ee ee ee eee ee ew ae een warn na mana Sawa men *} 
{* Task : Display hard disk partitioning *} 
{* a ss i lh cass ip see ies in woh aya acs ns ss ms es ie’ en mss ec ea cms Cam as ene Sm en Sn hus mb ey ets ems Slss es Se bn Ui so ccs coi me *} 
{* Author : MICHAEL TISCHER =} 
{* Developed on : 04/26/1989 *} 
{* Last update : 06/22/1989 *} 
{* es oes cts cess ca ci stem sks nS mmo cms mes ccs iscsi ind mu mush ms mien Catan io nn a inset cy coum mss ms immo elmo a Sani evs emu Gen Gmn's  e oneminls eiw ses wis e asGbew ea *} 
{* Call : FIXPARTP [ Drive number ] *} 
{* Default is drive 0 (drive C:) *} 
{HARK IKK RHR KKK KR KKK REI R EK IK KER KKK KK KEE RE KEKEKRERKEEKEKRERKEREREKEKKKEE | 
uses Dos; { Add DOS unit } 
type SecPos = record { Describes the position of a sector } 
Head : byte; { Read/write head } 
SecCyl : word; { Sector and cylinder number } 
end; 
PartEntry = record { Entry in the partition table } 
Status : byte; { Partition status } 
StartSec : SecPos; { First sector } 
PartTyp : byte; { Partition type } 
EndSec : SecPos; { Last sector } 
SecOfs : longint; { Offset of the boot sector } 
SecNum : longint; { Number of sectors } 
end; 
PartSec = record { Describes the partition sector } 
BootCode : array [0..$1BD] of byte; 
PartTable : array [1..4] of PartEntry; 
IdCode : word; { $SAA55 } 
end; 


{ EE RARKKHREK EKER KERR KHER KKK E KK KKK IKKAK RK EEK KKK KEKKEKEEKKEKKKEKKEKREE | 


{* ReadPartSec : Read a partition sector from the hard disk and *} 
{* place in a buffer sb 
{** ie nal wins sonst ine Sin sass ian Ch ec sn ms Si cg nis ci a e/a si il a Ws sl ce eh aaa ln pars ma Sc ics alc wii a i sn wa ass et a’ in Sas le es xe} 
{* Input : - HrdDrive : BIOS code of the drive ($80, $81 etc.) *} 
{* ~ Head : Read/write head number *} 
{* - SecCyl : Sector and cylinder number in BIOS format *} 
{* - Buf : Buffer into which sector should be loaded *} 
{ RE RRR RRR KR KERR KKK ERE RK K EKER KK REE KR EREKRKKEKEKRKKKREEKEREEEKKKEKE | 
function ReadPartSec( HrdDrive, Head : byte; 
SecCyl : word; 
var Buf : PartSec ) : boolean; 

var Regs : Registers; { Processor regs for interrupt call } 
begin 

Regs.AX := $0201; { Function no. for “Read", 1 sector } 

Regs.DL := HrdDrive; { Load additional } 

Regs.DH := Head; { parameters into the } 

Regs.CX := SecCyl; { different registers } 

Regs.ES := seg( Buf ); 

Regs.BX := ofs( Buf ); 

Intr( $13, Regs); { Call hard disk interrupt } 

ReadPartSec := ( Regs.Flags and 1) = 0; {Carry flag indicates error} 
end; 


{BARR RRR KR EKER RE KR HEK KER KEK ERIK ERERK KEK EKRKEKK KEK KEKEKEKRRKEKEEKREKEKEKEKKKEKEKE | 


{* GetSecCyl:, Determines the combined sector/cylinder coding of BIOS *} 


{* sector and cylinder number *} 
{** {a ssc i io es asi Sit Ms ‘in a sh is ee ina ei in cm Sms ee ee se ep nia hic mm ci a te cbc emo me ic te in i la hands en noth esis Sw xk} 
{* Input : SecCyl : Value to be decoded *] 
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{* Sector : Reference to the sector variable *} 


{* Cylinder : Reference to the cylinder variable *} 
{RA KKHERAREK EKER ERE EKER KERERKEKEERKEKEEKEKEREEREKREKREEKEREREKEKKEEE | 


procedure GetSecCyl ( SecCyl : word; var Sector, Cylinder : integer ); 


begin 
Sector := SecCyl and 63; { Exclude bits 6 and 7 } 
Cylinder := hi( SecCyl ) + ( lo( SecCyl) and 192 ) shl 2; 

end; 


{RRR RRR KEKE KEKRK EER ERE KKK KEKE EEK EKER HERE KREKKEKEEKEKKEKKEEEEE | 


{* ShowPartition: Displays hard disk partitioning on the screen *} 
{** ae ee eee cen ee oe se eee en nm ee se a ee we es cee ee ce me a ee ew ce ee ee DD we RD aU wen i De SnD Sm ec ees se ae} 
{* Input : DR : Number of the corresponding hard disk drive =} 
i* (0, 1, 2 etc.) x) 


{BERR REE ERKRK KERR ERK ER EKER KKK KER EKER EKER KEKE ERKEKRRE KEE KKEEKEKEEEEE } 


procedure ShowPartition( DR : byte )}; 


var Head >: byte; { Head of current partition } 
SecCyl : byte; { Sector and cylinder of current partition } 
ParSec : PartSec; { Current partition sector } 
Entry : byte; { Loop counter } 
Sector, { Get sector and } 
Cylinder : integer; { cylinder numbers } 
Regs : Registers; { Processor regs for interrupt call } 
begin 
writeln; 
DR := DR + $80; { Prepare drive number for BIOS } 
if ReadPartSec( DR, 0, 1, ParSec ) then { Read partition sector } 
begin { Sector is readable } 
Regs.AH := 8; { Read drive data } 
Regs.DL := DR; 
Intr( $13, Regs); { Call hard disk interrupt } 


GetSecCyl( Regs.CX, Sector, Cylinder ); 
ORL 1 a ety 
a; 
{ Upper left corner can be typed using <Alt><201> } 


{ Top horiz. line can be typed using <Alt><205> } 
{ Upper right corner can be typed using <Alt><187>} 


writeln('| Drive ‘, DR-$80, ‘: ', Regs.DH+1:2, 
‘ Heads with ', Cylinder:5, ' cylinders and ', 
Sector:3, ' sectors I"): 
{ Vert. lines can be typed using <Alt><186> } 
writeln('] Partition table in partition sector "+ 


: I"); 
{ Vert. lines can be typed using <Alt><186> } 
writeln (*4—l—T——___T—_________T''+ 
a; ey penne 8 Er) 
{ Left T can be typed using <Alt><204> } 
{ Top T can be typed using <Alt><209> } 
{ Right T can be typed using <Alt><185> } 
writeln('| | | | Start [+ 
‘ End [Dis.fr.| I"); 
{ First and last vert. lines can be typed using <Alt><186> } 
{ Remaining vert. lines can be typed using <Alt><179> } 
writeln('|#.|Boot|Type |Head Cyl. Sec.|'+ 
‘Head Cyl. Sec.|BootseciNumber |"); 
{ First and last vert. lines can be typed using <Alt><186> } 
{ Remaining vert. lines can be typed using <Alt><179> } 
writen (8 ———- gt + 
+ —$—_______+—____+___{'); 
{ left T can be typed using <Alt><204> } 
{ crosses can be typed using <Alt><216> } 
{ Right T can be typed using <Alt><185> } 
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for Entry:=1 to 4 do { Execute table entries } 
with ParSec.PartTable[ Entry ] do 
begin 
write('| ', Entry, ‘'|'); 
{ Type first line using <Alt><186>, second using <Alt><179> } 
if Status = $80 then write ("YES '} 
else write (' NO '); 
write('|'); 
{ Type thin vert. line using <Alt><179> } 


case PartTyp of { Display partition type } 
$00 : write('Not occupied uo 
$01 : write('DOS, 12-bit FAT "): 
$02 > write (‘ XENIX at 
$03 : write ('XENIX Ne 
$04 : write('DOS, 16-bit FAT ‘)F 
$05 : write('DOS, extd.partition'); 
SDB : write('Concurrent DOS ‘ys 
else write ('Unknown (',PartTyp:3, ‘) "}3 
end; 


Get SecCyl ( StartSec.SecCyl, Sector, Cylinder ); 


write('|', StartSec.Head:2,' ',Cylinder:5,' ‘,Sector:3 ); 
GetSecCyl( EndSec.SecCyl, Sector, Cylinder ); 
{Enter vert. line using <Alt><179> } 


write(' |', EndSec.Head:2,' ',Cylinder:5,' ',Sector:3 ); 
{Enter vert. line using <Alt><179> } 
writeln(' |', SecOfs:7,'|', SecNum:7, ']')? 
{ Enter first and second vert. lines using <Alt><179>, } 
{ third line using <Alt><186> } 
end; 
writeln (*|—t——j.———_ J] 
8 ff 1 3910) 5 
{ Left angle can be typed using <Alt><200> 
{ Horiz. lines can be types using <Alt><205> 
{ Bottom Ts can be typed using <Alt><207> 
{ Right angle can be typed using <Alt><188> 


nage yt eed tet 


end 
else 
writeln('Error during boot sector access!'); 
end; 


{ BAK KHIKKRKIKHKIHK IKE IKI KK KKK KEK IKKE HII KIERAN K AKA KKKKK 


* MAIN PROGRAM * 


HARK KKK ERR K KK KERR KKK KK KKK KKK KK KKK KKK KKH KK KKK K KKK KERR KEK KKKEKKKEKKKE | 


var HrdDrive, { Variables for converting } 
DError : integer; { given arguments } 
begin 
writeln( #13#10'-----~-----~-------~-------~------- FIXPARTP - (c)', 
‘ 1989 by MICHAEL TISCHER --~' ); 
HrdDrive := 0; { Default is first hard disk } 
if ParamCount = 1 then { Other drive specifier given? } 
begin { YES } 
val( ParamStr(1), HrdDrive, DError ); { ASCII/decimal } 
if DError <> 0 then { Conversion error? } 
begin { YES } 
writeln(#13#10'Illegal drive specifier!'); 
exit; { End program } 
end; 
end; 
ShowPartition( HrdDrive ); { Display partition sector } 
end. 
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C program: FIXPARTC.C 


[ERK KERRE KEKE RERKEKKKEKKKRE EKER EKER EKER AEEREEREKEEEEKEEKEEKKAEK | 


/* FIXPARTC.C */ 
JR ai i a ae a se ara aa ns ae ip Oa x/ 
/* Task : Displays hard disk partitioning Rf 
Ff ape a OTN SIT ea Tee Ep PO ee Pe EE A a ee OC */ 
/* Author : MICHAEL TISCHER */ 
/* Developed on : 04/26/1989 */ 
/* Last update : 06/22/1989 */ 
|B wenn nnn a nn a nn on on rn on ee */ 
/* Call : FIXPARTC [ Drive_number ] */ 
/* Default is drive 0 (Drive C:) */ 


[ERE KEKRKKK EEE KKK KKK KEE EEK EKER KEK REE KKEKRK KEKE KEKE AEE EEEKKKKEKKEKEKKK / 


#include <dos.h> 
#include <string.h> 
#include <stdlib.h> 


#define TRUE ( 
#define FALSE ( 


#define HI(x) ( *((BYTE *) (&x)+1) ) /* Returns high byte of a word */ 
#define LO(x) ( *((BYTE *) &x) ) /* Returns low byte of a word */ 


typedef unsigned char BYTE; 
typedef unsigned int WORD; 


typedef struct { /* Describes the position of a sector */ 
BYTE Head; /* Read/write head */ 
WORD SecCyl; /* Sector and cylinder number */ 
} SECPOS; 

typedef struct { /* Entry in the partition table */ 
BYTE Status; /* Partition status */ 
SECPOS StartSec; /* First sector */ 
BYTE PartTyp; /* Partition type */ 
SECPOS EndSec; /* Last sector */ 
unsigned long SecOfs; /* Offset of boot sector */ 
unsigned long SecNum; /* Number of sectors */ 


} PARTENTRY; 


typedef struct { /* Describes the partition sector */ 
BYTE BootCode[ Ox1BE ]; 
PARTENTRY PartTable[ 4 }; 
WORD IdCode; /* OxAA55 */ 
} PARTSEC; 


typedef PARTSEC far *PARSPTR; /* Pointer > partition sector in memory */ 


[RERRRKKKRKK KKK KKK KIKIKKEKEKK KEK KIKKKE KK EKER KEKKKKEKEKKEKEKEKKKAKKKAKKK / 
/* ReadPartSec : Reads a partition sector from the hard disk into a */ 


/* buffer */ 
/* Input : - HrdDrive : BIOS code of the drive (0x80, 0x81 etc.) 0 
/* ~ Head : Number of read/write heads */ 
/* ~ SecCyl : Sector and cyinder number in BIOS format x] 
7% - Buf : Buffer into which sector should be loaded */ 


/* Output : TRUE if sector is read without error, otherwise FALSE */ 
[RRR IKI KIRKE EK I KK II KHAKI IKK IIE HAKKAR EKA AKA KAKA KKEKKKKE | 


BYTE ReadPartSec( BYTE HrdDrive, BYTE Head, WORD SecCyl, PARSPTR Buf ) 
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union REGS Regs; /* Processor regs for interrupt call */ 
struct SREGS SRegs; 


Regs.x.ax = 0x0201; /* Funct.no. for “Read", 1 Sector */ 
Regs.h.dl = HrdDrive; /* Load parameters into */ 
Regs.h.dh = Head; /* different registers as */ 
Regs.x.cx = SecCyl; /* needed */ 


Regs.x.bx = FP_OFF( Buf ); 
SRegs.es = FP SEG( Buf ); 


int86x( 0x13, &Regs, &Regs, &SRegs ); /* Call hard disk interrupt */ 
return !Regs.x.cflag; 
} 


[RRR IKK IKKE KEK IRIE IKKE KKK REIKI RIKER IKRKEK IKK IAEKAIK IK / 
/* GetSecCyl: Determines the combined sector/cylinder coding from */ 


/* BIOS sector/cylinder number */ 
/* Input : SecCyl : Value to be decoded */ 
/* Sector : Reference to the sector variable a 
c* Cylinder : Reference to the cylinder variable */ 
/* Output: none */ 


[RRA IRI AKIRA IK IKI KIA IIIA ERRATA ITHAKA REIKI RTT KIA IAEA IKI AAIAR / 
void GetSecCyl( WORD SecCyl, int *Sector, int *Cylinder ) 


{ 
*Sector = SecCyl«£ 63; /* Exclude bits 6 and 7 */ 


*Cylinder HI (Sec 1) + ( ( (WORD) LO(SecCyl) & 192 ) << 2 ); 


[RRR IKKE REE REE RRR EKER AK KIRK RK KEIR IKE IKI HERE EKER REE EKER KEE / 


/* ShowPartition: Displays hard disk partitioning on the screen a] 
/* Input: LW : Number of the hard disk (0, 1, 2, etc.) */ 
/* Output: none +7 


[RR KKK HK KKK KIKI HIKER KKK KRK KER KEKE EKER KKK KKK KEKE KEKE KKK KKKKKKEE / 


void ShowPartition( BYTE LW ) 


{ 
#define AP ParSec.PartTable[ Entry ]} 


BYTE Head, /* Head for current partition */ 
Entry, /* Loop counter */ 
SecCyl; /* Sector and cylinder of current partition */ 
PARTSEC ParSec; /* Current partition sector */ 
int Sector, /* Get sector and cylinder */ 
Cylinder; /* number */ 
union REGS Regs; /* Processor regs for interrupt call */ 


princt ("\n"*)2 


LW |= 0x80; /* Prepare drive number for BIOS */ 
if ( ReadPartSec({ LW, 0, 1, &ParSec ) ) /* Read partition sector */ 
{ /* Sector can be read */ 
Regs.h.ah = 8; /* Read disk data */ 
Regs.h.dl = LW; 
int86( 0x13, &Regs, &Regs ); /* Call hard disk interrupt */ 


Get SecCyl ( Regs.x.cx, &Sector, &Cylinder ); 
printf ( ref 
a So ng 
/* Upper left corner can be typed using <Alt><201> */ 
/* Horizontal line can be typed using <Alt><205> sf 
/* Upper right corner can be typed using <Alt><187> */ 
printf( "| Drive %$2d: %2d heads with %$4da" 


" cylinders, %3d sectors j\n", 


LW-0x80, Regs.h.dhtl, Cylinder, Sector ); 
/* Vertical lines at beginning and end can be typed using <Alt><186> */ 
printf( “| Partition table in partition sector . 


“ J\n") - 
/* Vertical lines at beginning and end can be typed using <Alt><186> */ 
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printf ( —f—T— Tt —_————______T" 
Tf \ rn") 3 
/* Left T can be typed using <Alt><199> */ 
/* Horiz. lines can be typed using <Alt><205> */ 
/* Ts in middle of line can be typed using <Alt><209> */ 
/* Right T can be typed using <Alt><185> */ 
printf( "| | ] | Start \" 
" End |Dis.fr.| |\n"); 
/* First and last vertical lines in the above line ~y 
/* can be typed using <Alt><186> */ 
/* Remaining vertical lines can be typed using <Alt><179> */ 
printf ( “|#.|Boot|Type |Head Cyl. Sec.|" 
“Head Cyl. Sec.|BootSec|Number |\n"); 
/* First and last vertical lines in the above line */ 
/* can be typed using <Alt><186> */. 


/* Remaining vertical lines can be typed using <Alt><179> */ 
print £ ( %4——_-—— $j 


44+ dn) 5 
/* Left T can be typed using <Alt><204> w/ 
/* Horizontal lines can be typed using <Alt><205> */ 
/* Crosses can be typed using <Alt><215> it J 
/* Right T can be typed using <Alt><185> Bas 
/*-- Check partition table -----------------------~---------------- */ 


for ( Entry=0; Entry < 4; ++Entry ) 
{ ‘ 
printf( "| %dj", Entry ); 
/* First vertical line can be typed using <Alt><186> */ 
/* Second vertical line can be typed using <Alt><179> */ 
if ( AP.Status == 0x80 ) /* Partition active? */ 
printf ("Yes "); 
else 
printf ("No "); 
printf ("|"); 
/* Vertical line can be typed using <Alt><179> */ 


switch( AP.PartTyp ) /* Display partition types */ 

{ 

case 0x00 : printf( "Not occupied ee 
break; 

case 0x01 : printf( "DOS, 12-Bit FAT ae 
break; 

case 0x02 : printf( "“XENIX le S: 
break; 

case 0x03 : printf( “XENIX eae 
break; 

case 0x04 : printf( "DOS, 16-Bit FAT a 
break; 

case 0x05 : printf( "DOS, extended part." )?; 
break; 

case OxDB : printf( “Concurrent DOS =) 
break; 


default : printf( “Unknown (33d) e 
ParSec.PartTable[ Entry ].PartTyp ); 
} 


/*-- Display physical and logical parameters -------------------- a f 
GetSecCyl( AP.StartSec.SecCyl, &Sector, &Cylinder ); 
printf ( “|$2d %5d %3d “, AP.StartSec.Head, Cylinder, Sector ); 
/* Vertical line can be typed using <Alt><179> */ 
GetSecCyl ( AP.EndSec.SecCyl, &Sector, &Cylinder ); 
printf ( “|%2d $5d %3d “, AP.EndSec.Head, Cylinder, Sector }; 
/* Vertical line can be typed using <Alt><179> */ 
printf ( "|%6lu |$6lu j\n", AP.SecOfs, AP.SecNum ); 
} 
/* First and second vertical lines can be typed using <Alt><179> */ 
/* Third vertical line can be typed using <Alt><186> df 


printf ( *l—L—1———__—______ | —_____" 
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See tee Kn 
/* Left angle can be typed using <Alt><200> */ 
/* Horizontal lines can be typed using <Alt><205> */ 
/* Ts can be typed using <Alt><207> a A 
/* Right angle can be typed using <Alt><188> */] 


} 
else 
printf("Error during boot sector access!\n"); 


} 


[RR RRHI RIKKI II IKKE IKK IKK IKI AK KIKI IKKE IKARIA EKEEKKKAKKKK AK KK KKKKA 


* MAIN PROGRAM ms 


HHH IKK IKK RRR KEK IKK IKI K KK E KER ERE 


int main( int argc, char *argv[] ) 


{ 
int HrdDrive; 


printf( “\n----------------------+----- += FIXPARTC — (c)" 
"1989 by MICHAEL TISCHER ---\n" ); 
HrdDrive = 0; /* Default is first hard disk */ 
if ( argc == 2 ) /* Other drive specified? */ 
{ /* YES */ 
HrdDrive = atoi ( argv[1]} ); 
if ( HrdDrive == 0 && *argv{1] != ‘0° ) 
{ 
printf ("\nIllegal drive specifier!"); 
return( 1 ); /* End program */ 
} 
} 
ShowPartition( HrdDrive ); /* Display partition sector */ 


return( 0 ); 


} 
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Chapter 18 


The PC Ports 


Ports 


Chapter 2 of this book described a series of CPU support chips which help the 
CPU control the system. These chips stay in constant contact with the CPU, 
which delegates tasks to and obtains information from the support chips. 


The ports represent the interfaces between the CPU and the other system hardware. 
A port can be viewed as an 8-bit-wide data input or output connected to a particular 
piece of hardware. A port has an assigned address with values ranging from 0 to 
65,535. The CPU uses the data bus and address bus to communicate with the 
ports. If the CPU needs access to a port, it transmits a port control signal. This 
signal instructs the other hardware that the CPU wants to access a port instead of 
RAM. Ports have addresses which are also assigned to memory locations in RAM, 
but these addresses have nothing to do with those memory locations. The port 
address is placed on the lowest 16 bits of the address bus. This instructs the system 
to transfer the eight bits of information following on the data bus to the proper 
port. The hardware connected with this port receives the data and responds 
accordingly. 


The 80(x)xx processor series has two instructions that control this process from 
within a program. The IN instruction inputs data from a port to the CPU; the 
OUT instruction outputs data from the CPU to a port. 


The system can set the port address of a certain hardware device—this address is not 
a constant value. For this reason, there are many similarities in port addressing 
between the PC, XT and AT. There are few differences between the PC and XT, 
but many differences exist between the PC and AT. 
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The following table shows the port addresses of individual chips in each system. 


00-01F 


20-03F 
40-05F_| 
060-063 __j none 
[Keyboard (8042) none dt 060-06 F 
[Realtime clock _(Mc146818) none 070-07 F 
080-09F 
OAO-OBF_ 
0CO-ODF 
[Math coprocessor none OF 8- OFF 
[Expansion unit 210-217 none 
|300-31F _ 
|360-36F _| 
|378-37F | 


300-31F_ | 300-31F 
360-36F 
Interface for first parallel printer 378-37F 378-37F 


Monochrome Display Adapter and | BO-3BF 3B0-3BF 
parallel printer connection 
Color/Graphics Adapter 3D0-3DF 


3F0-3F7 
3F8-3FF 


Ww 


DO-3DF 
FO-3F7 
F8-3FF 


Ww 
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Chapter 19 


Interaction between 
Keyboard, BIOS and DOS 


The preceding chapters of this book described three levels of PC system 


architecture: 

° DOS 

. BIOS 

° hardware 


We've examined each level separately throughout this book. This chapter 
investigates the interaction between the three levels. We'll use the keyboard as an 
example, because it best illustrates the connection between the three levels. We'll 
Start with the lowest level (the hardware itself) and progress to the highest level (an 
application program which communicates with the user through the keyboard). 


Hardware level 


The hardware level consists of the keyboard itself, which connects to the CPU 
through a cable. This keyboard contains either an Intel 8048 (PC/XT) or 8042 
(AT) processor. The processor's task monitors the keyboard to determine whether a 
key was depressed or released. If a user depresses a key for longer than half a 
second, the 8048 enables key repeat at a rate of 10 characters per second. While the 
8048 can only repeat at this frequency, the 8042's repeat frequency can be changed 
to other values. This repetition continues until the user releases the key. The 
keyboard processor assigns each key a number, instead of a character or ASCII 
code. It views control keys such as <Shift> and <Ctrl> like any other key. In the 
83-key standard PC keyboard, the processor assigns numbers to the keys ranging 
from 1 to 83 decimal. 
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BIOS level 


When you press a key, this key code passes to the CPU as a byte. When you 
release the key the processor passes the code to the CPU again, along with an 
added 128. This is the same as setting bit 7 in the byte. The keyboard instructs the 
8259 interrupt controller that the CPU should trigger interrupt 9H. If the CPU 
responds we reach the next level, because a BIOS routine is controlled through 
interrupt 9H. While this routine is being called, the keyboard processor sends the 
key code to port 60H of the main circuit board using the asynchronous 
transmission protocol. The BIOS routine checks this port and obtains the number 
of the depressed or released key. This routine then generates an ASCII code from 
this key code. i 


This task is more complex than first appears, since the BIOS routine must test for 
a control key such as <Shift> or <Alt>. Depending on the key or combination of 
keys, either a normal ASCII code or an extended keyboard code may be required. 
The extended key codes include any keys which don't necessarily input characters 
(e.g., cursor keys). 


Once BIOS determines the correct code, this code passes to the 16-byte BIOS 
keyboard buffer. If it is full, the routine produces a beep which informs the user of 
an overflow in the keyboard buffer. The processor returns to the other tasks which 
were in progress before the call to interrupt 9. 


The next level, BIOS interrupt 16H, reads the character in the keyboard buffer and 
makes it available to a program. This interrupt includes three BIOS routines for 
reading characters from the keyboard buffer, as well as the keyboard status (e.g., 
which control keys were pressed). These three routines can be called with an INT 
assembly language instruction from an application program. 


DOS level 
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The keyboard's device driver routines represent the DOS level. These DOS routines 
read a character from the keyboard and store the character in a buffer, using the 
BIOS functions from interrupt 16H. In some cases, the DOS routines may clear 
the BIOS keyboard buffer. If the system uses the extended keyboard driver 
ANSLSYS, ANSLSYS can translate certain codes (e.g., function key 1) into other 
codes or strings. For example, it's possible to program the <F10> key to display 
the DIR command on the screen. You can theoretically call device driver functions 
from within an application program, but in practice DOS functions usually address 
these functions. 


DOS is the highest level you can go. Here you'll find the keyboard access 
functions in DOS interrupt 21H. These functions call the driver functions, 
transmit the results and perform many other tasks. For example, characters and 
strings can be read and displayed directly on the screen until the user presses the 
<Return> key. These strings are called by an application program and form the end 
of this chain of events. 
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___ Application program 
[Interrupt 21(h) (005 routine) 
[B05 keyboard arver 
[_trterrapt 16(h) (BIOS routine) 
Keyboardibutier 
interrupt 90m) (B10 routine) 


eae 
Keyboard with 8042 or 8048 processor 


Levels of keyboard access 


OLOLOIOTOLS 


The keyboard access levels are as follows: 


(1) 
(2) 


(3) 


(4) 
(S) 


(6) 


Enables functions available for keyboard access 


Reads a character with the functions of interrupt 16H and converts it into 
other characters or character strings as needed 


Reads keyboard status or a character from the keyboard buffer and transfers 
it to the calling program 


Accepts the character entered 


Receives codes from the keyboard, converts them into ASCII or extended 
keyboard codes and adds them to the keyboard buffer 


Calls interrupt 9 when the key is depressed or released 


When you consider the many levels through which a key code has to travel before 
reaching an application program, you might be thinking that direct keyboard access 
would be much faster. In principle that's true, but the process as described above 
offers several advantages. One advantage is that the system offers complex 
functions which reduce programming work, such as simultaneously displaying a 
line on the screen as you enter it from the keyboard. Also, using higher level 
functions make programs hardware independent, so that they'll run on PCs that 
may not be hardware-compatible with the IBM PC but still use DOS as the 
operating system. 
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The program which concludes this chapter demonstrates a method of changing the 
system levels. The challenge is to increase the size of the BIOS keyboard buffer. 
The keyboard buffer usually holds up to 16 characters before emitting beeps to tell 
the user that the buffer is full. 


The assembler program which follows increases the size of the keyboard buffer to 
128 characters (256 bytes). It generates extended interrupt handlers for hardware 
keyboard interrupt 09H and BIOS keyboard interrupt 16H. 


FERRER REE RI KIRKE EERE KRE RRR IKKE KER KKEERER EEE KEEREREKKEKE © 
;* KEYBUF ar 
om Sais cis Sons cha ui ms abs ase sah Mu ln ee ibs cs “Gee cas ce cs cee cn aoe cms a coals Sem Um cb nbc abc bs me uum sas wo Um cas as cs cus es en nb fc ws es ase coe ns ru is ss Sam Se as 
7? Task : Installs extended keyboard reading interrupt ms 
Hiss routines and implements a virtual keyboard ar 
Be buffer of up to 256 bytes (128 characters). 7 
as An initial call installs the program, while a *: 
= second call disables the program. *? 
. ST ics ons wa sts oi cen en Ss et ie ei ele ene i ct ao us en sci ms acs ido sis eve em ni cons ovement creme ks tas ene el ew sins cls So cams hi eta sccm ewes Sos *s 
7* Author : MICHAEL TISCHER *; 
7* Developed on : 08/24/1988 * 
7* Last update : 06/23/1989 * 
PRS Re eee Soe eee ar ee ea ee eee aan * 
7* Assembly : MASM KEYBUF; *; 
z* LINK KEYBUF; *; 
* EXE2BIN KEYBUF KEYBUF.COM *; 
ree eas nos es sain es ces mone eras ues ‘Sv see ars Commis eis i's ul Sams seis ‘ums coms cm cas stain tush cesta in inna cn is cw ew cies ems es od Sc Sass Mk Sau ec ns en Ge cos 'cct cn gm cs ei mec‘ *s 
7* Call > KEYBUF <7 
FERRER ERK KEKE KEE KER KRE KR KEKRKEKKREEKREHKRRERKERKEKKRKREKKRERKEKEKKKEKHKREKKK 9 


bios segment at 40h 7Segment begins at 0040:0000 
org lah 


7~-~- BIOS pointer points to the keyboard ring buffer ---~~------ 


b next dw (?) Pointer to next character 

b last dw (2?) 7Pointer to last character 

bios ends 

7== ConstantS ==s=sss=2ss=sssssesssesssssssasss Sse sEssEasESassSessssSss tse 
KB_ LEN equ 128 7Keyboard buffer length must be a 


spower of 2 (change this constant to 
;change the size of the keyboard buffer 
7e.g., 2, 4, 8, 16, 32, etc.) 


;== Start of program Cn et tt 
code segment para ‘CODE’ ;Definition of CODE segment 
org 100h 


assume cs:code, ds:code, es:code, ss:code 


start: jmp kb ini First executable instruction 

;== Data (stays in memory) =======s=se=ss=sess=sessesssssessseeseesss== 
keybuf_id dw "cs" ;Identifies the program 

env_seg Gw (?) 7Segment address of environment 

int9 equ this dword 7Old interrupt vector 09H 
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int9 ofs dw (?) ;Offset address interrupt vector 09H 
int9 seg dw (?) ;Segment address interrupt vector 09H 
int16 equ this dword 7Old interrupt vector 16H 


;Offset address interrupt vector 16H 
7Segment address interrupt vector 16H 


int16 ofs dw (?) 
intl6 seg dw (?) 


z-- Virtual keyboard buffer is placed in the PSP of this program, ------ 
7-- making the program resident until a second call disables it ------ 


7Offset address of next key 
;O0ffset address of current key 


next key dw 0 
curkey dw KB LEN - 2 


new _int9 proc far 


assume ds:bios 


pushf 


7;New INT 9H handler 
;Assign DS the BIOS variable segment 


7;Simulate interrupt call to old INT 


call cs:int9 79H handler 


7-- Get character from BIOS keyboard buffer ------------------ 


cli 

push es 7Push all registers which will be 

push ds ;changed by this new interrupt 

push di zhandler onto the stack 

push bx 

push ax 

mov ax,bios 7;Get segment address of BIOS variable 

mov ds,ax ;segment to DS 

mov di,cs:nextkey sMove DI to next character in KEYBUF 

mov bx,b next ;BIOS: Get address of next character 
ni9 0: cmp bx,b last 7Still a character in BIOS kbd buffer? 

je ni9 end 7No more characters --> END 

7-- Still a character in the BIOS keyboard buffer -- 

mov ax, [bx] 7;Get character from BIOS kbd. buffer 

add bx,2 7Set pointer to next character 

cmp bx, 3eh ;Reached end of keyboard buffer? 

jne ni9 1 7;NO --> NI9 1 

mov bx,leh 7YES --> Set start of kbd. buffer 


ni9 1: cmp 


di,cs:curkey 


;Virtual keyboard buffer full yet? 


je ni9 0 7YES --> Don't store any more chars 
mov cs: [di],ax ;Characters in virtual kbd. buffer 
add di,2 7Set pointer to next character 
and di,KB LEN-1 ;Wrap-around 
jmp nig9 0 7Get next character 

ni9 end: mov cs:nextkey,di ;Mark position for next character 
mov b next, bx 7Set BIOS pointer to next character 
pop ax 7Pop registers off of stack 
pop bx 
pop di 
pop ds 
pop es 
iret ;Return to interrupt caller 


assume ds:code 


7DS indicates code segment 


new int9 endp 


7-~- New handler for BIOS keyboard interrupt 16H ---------------------- 
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new_intl16 proc far 7New interrupt 16H handler 
sti zEnable interrupt 
cmp ah,1l ;Read keyboard status? 
ja status 7;YES --> Status 


z-- Update keyboard LEDs when function 1 of the old keyboard - 
7-- handler is called 


push ax sPush function code on the stack 
pushf 7;Push flags onto stack 
mov ah,1 7Funct.no.: Key ready? 
call cs: [int16] 7Call old handler 
pop ax 7;Pop function code off of stack 
push bx 7;Push BX onto stack 
ni16 0: mov bx,cs:curkey 7Get pointer to current key 
add bx, 2 7Set to next word 
and bx,KB LEN-1 ;Wrap~-around 
or ah, ah ;Read character? 
je nil6é 2 7YES --> Get character from buffer 


7-- Function 1: Help caller determine whether a character is - 
3-- available - 


cmp bx, cs:nextkey ;Found a character in KEYBUF? 

je nil6é 1 7NO --> NI16_1 

mov ax,cs: [bx] 7YES, Get character from KEYBUF 
nilé 1: pop bx 7Pop BX off of stack 

ret 2 ;Return to caller but DO NOT remove 


7;flags from stack 


7-~- Function 0: Read character from the keyboard buffer ------ 


ni16 2: cmp bx,cs:nextkey ;Character found in KEYBUF? 
je nilé 0 7NO --> NI16_0 
mov ax,cs: [bx] *YES -- > Get character from KEYBUF 
mov cs:curkey, bx 7Store position for current character 
pop bx 7;Pop BX off of stack 
iret ;Return to caller 

status: jmp cs: [(int16] 7;Jump to old handler 


new_intl16 endp 


instend equ this byte ;Everything must remain resident up 
sto this memory location 


;== Data (cann be overwritten from DOS) ====s====s=rss=ses=ss=ssess=sssss== 
installm db 13,10,"--- KEYBUF (c) 1988 by Michael Tischer ---",13,10,13,10 
db “KEYBUF now enabled. Entering KEYBUF a second time",13,10 
db “from the DOS prompt disables the KEYBUF program.",13,10,"$" 


removeit db 13,10,"--- KEYBUF (c) 1988 by Michael Tischer ---",13,10 
db “KEYBUF program now disabled.",13,10,"$" 


7== Program (can be overwritten from DOS) ======s==sssess==s=s==sssH==s==s== 
r;—~ Start and nitialization routine ------------------------------------ 
kb ini label near 


mov ax,3509h 7Get contents of interrupt vector 9H 
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install 


21h 


es:keybuf_ id, “Cs" 


install 


dx,es:int9 
ax, 2509h 
21h 


dx,es:int16 
ax, 251 6h 
21h 


bx, es 
es,es:env_seg 
ah, 49h 

21h 


es, bx 
ah, 49h 
21h 


cs 
ds 


dx,offset removeit 


ah, 9 
21h 


ax, 4C00h 
21h 


Install KEYBUF 


label near 


MOV 
int 
mov 
mov 


mov 
int 
mov 
mov 


cli 
mov 
mov 
int 


Mov 
mov 
int 
sti 


mov 
mov 
int 


ax, [2Ch]} 
env_seg,ax 


ax, 3509h 
21h 

int9 seg,es 
int9 ofs,bx 


ax, 3516h 

21h 
int16_seg,es 
int16_ofs, bx 


ax, 2509h 


7Cal DOS function 
;Program already installed? 
7;NO --> Install 


If KEYBUF is already installed, remove it --<<--<<<-------- 


;Disable interrupts 

7DS:DS = old handler address int 9H 
;Return interrupt vector for int 9H 
sto old interrupt handler 


7DS:DS = Old handler address int16H 
;Return interrupt vector i6H to oid 
zinterrupt handler 

7Enable interrupt 


;Move segment address of program 
7Get segment address of environment 
;from code segment and 

;release memory 


7Release memory of 
7;old KEYBUF using 
7;DOS interrupt 49H 


7;Push CS onto stack 
7Pop DS off of stack 


7Message: Program disabled 
;Write function number for string 
7;Call DOS function 


7Funct. no.: End program 
7Call DOS interrupt --> END 


In order to configure new keyboard buffer within the -- 
PSP, the segment address must first be moved to the end -- 
of the PSP, where it cannot be overwritten -- 


;Lead segment address of environment 
;and place in code segment 


7;Get contents of interrupt vector 9H 
7Call DOS function 

;Mark segment and offset address of 
;interrupt vector 9H 


zget contents of interrupt vector 16H 
7Call DOS function 

7Mark segment and offset address of 
sinterrupt vector 16H 


7Disable interrupt 
;Funct. no.: Set interrupt vector 9H 


dx,offset new int9 ;Offset addr. of new int. 9H handler 


21h 


ax, 2516h 


7;Call DOS interrupt 


7Funct. now: Set interrupt vector 16H 


dx,offset new_intl6;Offset addr. of new int. 16H handler 


2ih 


7Call DOS interrupt 
;Enable interrupts 


dx,offset installm ;Message: Install program 


ah, 9 
21h 


7Function number for string display 
3;Call DOS function 
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z-- Just PSP, new interrupt routine and corresponding -------- 
g-~- data must be resident (422 ae ne ee ence ee 


mov dx,offset instend ;Get offset address of last byte 


add dx,15 ;Make paragraph “full" 
mov cl,4 ;Compute number of resident 
shr dx,cl 7; paragraphs 
mov ax,3100h ;Terminate but keep resident program 
int 21h swith end code of (0) 
code ends z;End of code segment 


end start 
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Appendices A to F contain descriptions of each interrupt. 


Appendix A. Important Hardware Interrupts 710 
Appendix B. BIOS Interrupts and Functions 713 
Appendix C. DOS Interrupts and Functions 766 
Appendix D. EMM Functions 849 
Appendix E. EGA/VGA BIOS Functions 856 
Appendix F. Mouse Driver Interrupts 882 


These descriptions include documentation of the interrupt, any sub-functions (if 
applicable) and a listing of input and output registers (if applicable). Each interrupt 
title has the following format: 


Interrupt hex_numberH Interrupt type (i/o_register) 
Interrupt name 


Every processor register important to the called function is mentioned. Registers 
that aren't included in this list don't apply to the called function, and can contain 
any value during the call of the interrupt. 


The output listing identifies the register that contains information returned by the 
function after the call is completed. The register assignment depends on whether or 
not the function call is successfully executed. If a specific value is supposed to be 
in the AX register after a successful execution, but the function doesn't execute 
properly, then the value in this register won't have any meaning. Problems in each 
function will be addressed as needed. 


In addition to the description of the input and output registers, details about the 
function may also be included. For example, the function may be used in 
conjunction with another function. There may also be information about any 
changes in register contents caused by the function call. This is very important to 
the assembly language programmer who wants to keep data in a register after the 
function call. This programmer wants to avoid any changes in the contents of the 
registers. 
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Important Hardware 
Interrupts 


Interrupt 00H Hardware (CPU) 
Division by zero 


The CPU calls this interrupt when it encounters a divisor of 0 during one of the 
two assembly language division instructions (DIV or IDIV). According to the rules 
of mathematics, dividing a number by 0 is illegal. During the booting process, 
this interrupt points to a routine that, when called, displays the "Division by Zero" 
error message (or a similar message) on the screen. The interrupt continues with 
the execution of the current program. 


Interrupt 01H Hardware (CPU) 
Single step 


The CPU calls this interrupt when the TRAP bit in the flag register of the CPU 
has been set to 1. Then the interrupt is called after the execution of each assembly 
language instruction. This allows the user to follow these instructions, determine 
the changes in register contents and determine which instructions are executed. To 
prevent the call of the interrupt after the execution of every instruction in the trap 
routine (which would create an endless loop and a stack overflow), the processor 
resets the TRAP bit upon entry to the trap routine. If the trap routine ends with 
the IRET instruction, it automatically resets the TRAP bit to its old value by 
restoring the complete flag register from the stack. Because of this, the execution 
of the next instruction calls interrupt 1 again. Once the programmer has obtained 
the necessary information about a program from single step mode, the TRAP 
mode (or TRAP bit) can be disabled. 
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Interrupt 02H Hardware (CPU) 
NMI 


The hardware calls this interrupt when an error is discovered in the RAM chips. 
The system calls the non-maskable interrupt because this type of error impairs the 
capabilities of the system, and can lead to a crash. The NMI has the highest 
priority of all interrupts and therefore is executed faster than other interrupts. The 
NMI usually calls a BIOS routine which informs the user of a memory error, lists 
the number of defective memory chips and stops the system. 


If the NMI detects an error, the math coprocessor included in some PCs can also 
trigger the NMI. Even though NMI usually cannot be suppressed, the PC allows 
an exception to this rule. Some PC/XT and AT models have a special port (port 
AOH on PCs and XTs, port 70H on ATs). If a O value is written to one of these 
ports, the NMI interrupt is disabled . If the ports return the value 80H, the NMI 
interrupt is enabled. 


Interrupt 03H Hardware (CPU) 
Breakpoint 


While the other interrupts can be called with a two-byte assembly language 
instruction (first byte CDH, second byte the number of the interrupt), interrupt 3 
is called by the single-byte instruction CCH. This interrupt can be used to test 
programs when you want to execute the program up to a certain instruction, then 
stop and display the current register contents. Utilities designed for program testing 
like DEBUG implement this by placing calls for interrupt 3 where the break 
should occur. When the program is executed and the processor reaches the 
instruction, it calls interrupt 3. The program testing utility contains a routine 
which displays the register contents and other information. 


Interrupt 04H Hardware (CPU) 
Overflow 


This interrupt can be called by the INTO (INTerrupt on Overflow) conditional 
assembly language instruction. The call occurs when the overflow bit in the flag 
register is set during the execution of the INTO instruction. This can happen 
following math operations (e.g., multiplication with the MUL instruction) that 
produce a result which cannot be represented within a specified number of bits. 
This interrupt can also be called with the normal INT instruction, but this 
instruction isn't controlled by the status of the set overflow bit. Since it is seldom 
used, DOS points this interrupt to an IRET instruction. 


Interrupt 05H BIOS 
Hardcopy 


BIOS calls this interrupt when the user presses the <Prt Sc> key. The system then 
makes a hardcopy by sending the current screen contents to a printer. BIOS 
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initializes the interrupt vector from the vector table and points to the BIOS 
hardcopy routine in ROM-BIOS. Assembly language and programs written in 
higher level languages can use this interrupt with the INT instruction to get a 
hardcopy during program execution. 


Interrupt 08H Hardware (8259 interrupt controller) 
Timer 


In the PC, the 8259 timer chip receives 1,193,180 signals per second from the 
heart of the system, which is an oscillating quartz crystal. After 65,536 of these 
signals (1 second), it triggers a call of interrupt 8, which the 8259 transmits to the 
CPU. Since the frequency of the call of this interrupt is independent of the system 
clock frequency, interrupt 8 works well for timekeeping. The PC also uses the 
interrupt for timekeeping. BIOS points the interrupt vector of this interrupt to its 
own routine, which is called 18.2 times per second. A time counter increments 
every second and disables the disk drive motor if disk access hasn't occurred within 
a certain time period. 


Interrupt 09H Hardware (8259 interrupt controller) 
Keyboard 


PC keyboards contain an independent processor. This Intel processor carries either 
the number 8048 (PC/XT) or 8042 (AT). This processor monitors the keyboard 
and registers whether a key was depressed or released. When either of these actions 
occur, this processor must inform the CPU so that the code of the activated key 
can be sent to the system and processed. The keyboard instructs the interrupt 
controller to call interrupt 9. This interrupt calls a BIOS routine that reads the 
character from the keyboard and places it into the keyboard buffer. 
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BIOS 


Interrupts and 


Functions 


Interrupt 10H: 


Interrupt 11H: 
Interrupt 12H: 


Interrupt 13H: 


Video functions 


Function Description Page Number 
00H SEL VIDEO OE i ssaceecincccdeces anedenedaatdaneatarauaeieciecs 716 
01H De RNE CUISOR Ly De scanscsiasidelieacemecesesceneodenectdasgesatine 716 
02H POSItiOn CUISOR sosscsxcsescetecsmosesucstovancitidasemvusasactees 717 
03H Read Cursor DOSINON ons. ciiscessscseoncsisceewsncdaeiwieewossenes 718 
04H Read Tohtpen position .icsccscssassincesweacianencescccpuaseeas 718 
05H Select current display Ppage..............sscsscescesecscssceeees 719 
06H Initialize window/scroll text upward ................sss000 719 
07H Initialize window/scroll text downward ...............0008- 720 
08H Read character/attribute.................ccccsssseseceeseseeceeees 720 
09H Write character/attribute...................cccssssecccssescceees 721 
OAH WEG: CHALACIOR oid Ga secienckessre es eeciataniecee acceesene 722 
OBH Select palette (Sub-function 0) ...............scceesceceeceeees 723 
OBH Select color palette (sub-function 1)...................ss000 723 
OCH WHILE Qrapnic: PIXChisssisdoeeeeecavascea ceric id eeeaiotadedc 724 
0DH Read: oraphic- pixel cecccccsntesiecentunenuiesen 724 
0EH WIIG CHALACIER i catelecsidevel an siaieeaccestisc een eusass 725 
OFH REA “Gisplay: MOGE sisesesebeticauvesesetsveccessvcicssiessnivetss 726 
13H Write character string (AT onll)...............cccccccccccceee 726 
Determine configuration ..................ccccsscsecees 727 
Determine MEMOTY SIZEC.................scccccccceesceees 728 
Disk 
Function Description Page Number 
OOH Reset floppy disk SyStem.................csssccseccssssssescees 729 
01H Read Gisk Stguus cs coso0s: se psalcreconsseuesnaatvedseahinaccoote 730 
02H PRO AC ISK rasvissiscactcudtsuusccoseend conse cacseusanecwish Meena ees: 731 
03H WHE (0 GISK  oscicasspncetestansatssonesaneriowerse tocteuceveooes 731 
04H Verily “disk SCClOIS csccssccovsSascse. Mies siacecees eevee 732 


Appendix B: BIOS Interrupts and Functions PC System Programming 


Interru;t 13H: 


Interrupt 14H: 


Interrupt 15H: 


Interrupt 16H: 


05H FORMAL ACK ose ciccsiiedecacsas ss sapenesevebeetaunesaesteaees 733 
15H Determine drive type (AT only) .............2cccescecescoeces 734 
16H Determine disk change (AT only)..............csssscescoeees 735 
17H Determine disk format (AT only) ...............seccccssscees 735 
Hard disk 
00H Reset (XT and AT onlly)............csccsccescsscssceccsceescees 736 
01H Read disk status (XT and AT onlly).............ceccocseceees 736 
02H Read disk (XT and AT only)...............ccccossssssssesesses 737 
03H Write to disk (XT and AT onlly)..............cecescssescceces 738 
04H Verify disk sectors (XT and AT only)..............cccseees 740 
OSH Format cylinder (XT and AT only) ..............ccsccecceees 741 
08H Check format (XT and AT only) ..............ccescecesceeees 742 
09H Adapt to foreign drives (XT and AT only)................. 743 
OAH Extended read (XT and AT only)..............cscssessseseeees 744 
OBH Extended write (XT and AT onlly).............cccccecescesees 745 
0DH Reset (XT and AT only)..............csscesssscesscscescesscees 746 
10H Drive ready ? (XT and AT only)..............ceeescecsecseoes 747 
11H Recalibrate drive (XT and AT only) .................cecseees 748 
14H Controller diagnostic (XT and AT only) ...............206 748 
15H Determine drive type (AT only) ..............cesceecscnerees 749 
Serial interface 
Functi iption 
00H TMI ALI ZO: xioscstsiscicen cote sccuanuseoeesereodeciaecausseeussesassens 750 
01H Output Character ces csdeets vassals escedaviacensncesaaleenenan 751 
02H INDUECNATACIED toca iid iciehestecsce oineetncccseaccsevensia ue: 751 
03H IRCA: SEAN eh eceons co caadenes oe sed nies se eod aa eee eee, OS 
Cassette interrupt (AT only) 
Function Description P mber 
83H Set flag after time interval (AT only)................cesce0. 752 
84H Read joystick fire button (sub-function 0) (AT only)...753 
84H Read joystick position (sub-function 1) (AT only)......753 
85H <Sys Req> key activated (AT only)..............ceceeeseees 754 
86H Walt (AT ONLY) eaiscasrcneisscrentiw cee 754 
87H Move memory areas (AT OMY) 2s sscotbeeusienvatvawsacadteonss 754 
88H Determine memory size beyond 1 megabyte (AT only)755 
89H Switch to protected mode (AT only) .............cescseceees 755 
Keyboard 
nction Descripti Pp. mber 
OOH RAG CHALACIER: yiaesceictetavaclayiescersuavesecetassateenucarenenss 756 
01H Read keyboard for character ..............cscsscscecescscseeeces 756 
02H Read keyboard Status ..............cccccsssssssccecccessseseess 757 
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17H: Parallel printer 
OOH WHILE “CNALACICR - oiciceses, ctcaedinsdeteaioscctsensetemcesanaseane 757 
01H WIGALIZES PHINMEL sesh cscccapccssasdcccenpiteauecdetesiatednesses’ 758 
02H Réad “printer Status: cicicsciikacdskicciastiesnsitec onsen 758 
18H: Call ROM: BASIC viseiccsscssasincccrincesssies etwas 759 
19H: BOOE  DTOCOSS sascios ce isde dois coer tseslewosweends 759 
1AH: Date and time 
Function Description Page Number 
00H Read HME COUNLER <6. secs shincevesis ie casaevdecieeekies 759 
01H SEL CME COUNIEE fois icescnsiaccacdsoncsercrcesssmeemiessa tenes 760 
02H Read realtime clock (AT onlly)..............csscsecssceeescees 760 
03H Set realtime clock (AT only).............scscsccscscseceescees 761 
04H Read date from realtime clock (AT only)................06 761 
05H Set date in realtime clock (AT only) ...............cceceeees 762 
06H Set alarm time (AT only) ..............sccsceesscsecscsecececes 762 
07H Reset alarm time (AT Omly) ..............cececseceescecsececes 763 
1BH: <Break> key pressed................cccccsssssccsssscessees 763 
1CH Periodic interrupt ..................ccccccsscssscescneeecoees 764 
1DH VIDEO: CADIG ries esscssecictbaewsteaenexeatetaceeseniuenees 764 
1EH DPIVG: CAD IG sesccs hosncccsacaasaticererensent eats 764 
1FH Character table.................ccccccsccececcescescscceecees 765 
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Interrupt 10H, function 00H BIOS 
Video: Set video mode 


Selects and initializes a video mode and clears the screen. This function is a fast 
method of clearing the screen while maintaining the current video mode. 


Input: AH = 00H 
AL= Video mode 
0: 40x25 text mode, monochrome (color card) 
1: 40x25 text mode, color (color card) 
2: 80x25 text mode, monochrome (mono card) 
3: 80x25 text mode, color (color card) 
4: 320x200 4-color graphics (color card) 
5: 320x200 4-color graphics (color card) 
(colors displayed in monochrome) 
6: 640x200 2-color graphics (color card) 
7: Internal mode (mono card) 
Output: No output 
Remarks: The colors for modes 4, 5 and 6 can be set with function 11. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 01H BIOS 
Video: Define cursor type 


Defines the starting and ending lines of the cursor. This cursor exists independently 
of the current display page. 


Input: AH= 01H 
CH = Starting line of the cursor 
CL= Ending line of the cursor 
Output: No output 


Remarks: The values allowed for the cursor's starting and ending line depend on the 
installed video card. The following values are permitted: 


Monochrome display cards: 0-13 
Color display cards: 0-7 


BIOS defaults to the following values: 


Monochrome display cards: 11-12 
Color display cards: 6-7 
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You can use this function to set the cursor only within the permitted 
ranges. Setting cursor lines outside these parameters may result in an 
invisible cursor or system problems. 


The contents of the BX, CX, DX registers and the segment registers SS, 
CS and DS are not affected by this function. The contents of all the other 
registers may change, especially the SI and DI registers. 


Interrupt 10H, function 02H BIOS 
Video: Position cursor 


Repositions the cursor, which determines the screen position for character output 
by using one of the BIOS functions. 


Input: 


Output: 


Remarks: 


AH = 02H 

BH= Display page number 
DH = Screen line 

DL= Screen column 


No output 


The blinking cursor moves through this function when the addressed 
display page is the current display page. 


Values for the screen line parameter range from 0 to 24. 


Values for the screen column parameter range from 0 to 79 (for an 80- 
column display) or from 0 to 39 (for a 40-column display), depending on 
the selected video mode. 


You can make the cursor disappear by moving it to a nonexistent screen 
position (e.g., column Q, line 25). 


The number of the display page parameter depends on how many display 
pages are available to the video card. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 
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Interrupt 10H, function 03H BIOS 
Video: Read cursor position 


Senses the text cursor's position, starting line and ending line in a display page. 


Input: 


Output: 


Remarks: 


AH= 03H 
BH= Display page number 


DH = Screen line in which the cursor is located 
DL= Screen column in which the cursor is located 
CH = Starting line of the blinking cursor 

CL= Ending line of the blinking cursor 


The number of the display page parameter depends on how many display 
pages are available to the video card. 


Line and column coordinates are related to the text coordinate system. 


The contents of the BX register and the SS, CS and DS segment registers 
are not affected by this function. The contents of all the other registers 
may change, especially the SI and DI registers. 


Interrupt 10H, function 04H BIOS 
Video: Read lightpen position 


Senses the position of the lightpen on the screen if applicable. 


Input: 


Output: 


Remarks: 


AH = 04H 


AH = Lightpen position reading status 

0: Lightpen position unreadable 

1: Lightpen position readable 
DH = Screen line of the lightpen (text mode) 
DL= Screen column of the lightpen (text mode) 


CH= Screen line of the lightpen (graphic mode) 


BX= Screen column of the lightpen (graphic mode) 


This function call must be repeated until 1 is returned in the AH register, 
because only then can coordinates be read from the other registers. 


Coordinates indicated represent the current video mode's resolution. 


Usually the coordinates of the light pen cannot be accurately sensed in the 
graphic mode. The Y-coordinate (line) is always a multiple of 2, so it 
isn't possible to determine whether the lightpen is in line 8 or 9. The X- 
coordinate (column) is always a multiple of 4 in 320x200 graphic mode 
and a multiple of 8 in the 640x200 bitmap mode. 


The contents of the CL register and the SS, CS and DS segment registers 
are not affected by this function. The contents of all the other registers 
may change, especially the SI and DI registers. 
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Interrupt 10H, function 05H BIOS 
Video: Select current display page 


Selects the current display page (text mode only) which should be displayed. 


Input: AH = 05H 
AL= Display page number 

Output: No output 

Remarks: The number of the display page depends on the number of display pages 
available to the video card. 


On switching to a new display page, the screen cursor points to the 
position of the text cursor in this page. 


Switching between various display pages does not affect their contents 
(the individual characters). 


You can write characters to an inactive display page. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of the 
other registers, such as the SI and DI registers, may change. 


Interrupt 10H, function 06H BIOS 
Video: Initialize window/scroll text upward 


Clears window or scrolls a portion of the current display page up by one or more 
lines, depending on the input. 


Input: AH= 06H 
AL= Number of window lines to be scrolled upward (O=clear window) 
CH = Screen line of the upper left corner of the window 
CL = Screen column of the upper left corner of the window 
DH = Screen line of the lower right corner of the window 
DL= Screen column of the lower right corner of the window 
BH= Color (attribute) for blank line(s) 


Output: No output 
Remarks: Initializing a window (placing a 0 in the AL register) fills the window 
with blank spaces (ASCII code 32). 


The contents of the lines scrolled out of the window are lost and cannot 
be restored. 


Function 0 of this interrupt is better for clearing the entire screen. 
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The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 07H BIOS 
Video: Initialize window/scroll text downward 


Clears window or scrolls a portion of the current display page up by one or more 
lines, depending on the input. 


Input: AH= 07H 
AL= Number of window lines to be scrolled downward (O=clear window) 
CH = Screen line of the upper left corner of the window 
CL= Screen column of the upper left corner of the window 
DH = Screen line of the lower right corner of the window 
DL= Screen column of the lower right corner of the window 
BH= Color (attribute) for blank line(s) 


Output: No output 
Remarks: This function only affects the current display page. 


Initializing a window (placing a 0 in the AL register) fills the window 
with blank spaces (ASCII code 32). 


The contents of the lines scrolled out of the window are lost and cannot 
be restored. 


Function 0 of this interrupt is better for clearing the entire screen. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 08H BIOS 
Video: Read character/attribute 


Reads the ASCII code of the character at the current cursor position and its color 
(attribute). | 


Input: AH = 08H 
BH= Display page number 


Output: AL= ASCII code of the character 
AH = Color (attribute) 
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The number of the display page depends on the number of display pages 
made available to the video card. 


This function can also be called in graphic mode. The function compares 
the bit pattern of the character on the screen with the bit pattern of the 
character in character ROM of the video card and with the character 
patterns stored in a RAM table whose addresses appear in interrupt 1FH. 
If the character cannot be identified, the AL register contains the value 0 
after the function call. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of the 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 09H BIOS 
Video: Write character/attribute 


Writes a character with a certain color (attribute) to the current cursor position in a 


predefined display page. 

Input: AH = 09H 
BH= Display page number 
CX = Number of times to write the character 
AL= ASCII code of the character 
BL= Attribute 

Output: No output 

Remarks: If the character should be displayed several times (the value of the CX 


register is greater than 1), all characters must fit into the current screen 
line in the graphic mode. 


The control codes (e.g., bell, carriage return) appear as normal ASCII 
codes. 


This function can display characters in graphic mode. The patterns of the 
Characters, with the codes from 0 to 127, are determined by a table in 
ROM. The patterns of the characters with the codes from 128 to 255 are 
determined by a RAM table that was previously installed by DOS the 
GRAFTABL command. 


In text mode, the contents of the BL register define the attribute byte of 
the character. In graphic mode this register determines the color of the 
character. The 640x200 bitmap mode only allows the values 0 and 1 for 
selecting colors from the color palette. The 320x200 bitmap mode only 
allows the values 0 to 3 for selecting colors from the color palette. 


If the graphic mode is active during character output and bit 7 of the BL 


register is set, an exclusive OR is performed on the character pattern and 
the graphic pixels behind the character pattern. 
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After character output, the cursor remains in the same position as the 
character. i 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 0AH BIOS 
Video: Write character 


Writes a character to the current cursor position in a predefined display page by 
using the color of the character previously at this position. 


Input: 


Output: 


Remarks: 
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AH= 0AH 

BH= Display page number 

CX = Number of times to write the character 
AL= ASCII code of the character 


No output 


If the character should be displayed several times (the value of the CX 
register is greater than 1), all characters must fit into the current screen 
line in the graphic mode. 


The control codes (e.g., bell, carriage return) appear as normal ASCII 
codes. 


This function can display characters in graphic mode. The patterns of the 
characters with the codes from 0 to 127 are determined by a table in ROM 
and the patterns of the characters with the codes from 128 to 255 are 
determined by a RAM table previously installed by the GRAFTABL 
command. 


In text mode, the contents of the BL register define the attribute byte of 
the character. In graphic mode this register determines the color of the 
character. The 640x200 bitmap mode only allows the values 0 and 1 for 
selecting colors from the color palette. The 320x200 bitmap mode only 
allows the values 0 to 3 for selecting colors from the color palette. 


If the graphic mode is active during character output and bit 7 of the BL 
register is set, an exclusive OR is performed on the character pattern and 
the graphic pixels behind the character pattern. 


The cursor remains in the same position after character output. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 
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Interrupt 10H, function OBH, sub-function 0 BIOS 
Video: Select palette 


Selects the border and background color for graphic or text mode. 


Input: AH = O0BH 
BH= 0 
BL= Border/background color 
Output: No output 
Remarks: In graphic mode, the color value passed defines the color of both the 


border and background. In text mode, the background color of each 
character is defined individually, so the passed color value only defines the 
color of the screen border. 


Values for the colcr passed can range from 0 to 15. 
The contents of the BX, CX, DX registers and the SS, CS and DS 


segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function OBH, sub-function 1 BIOS 
Video: Select color palette 


Selects one of the two color palettes for the 320x200 bitmapped graphic mode. 


Input: AH = OBH 
BH= 1 
BL= Color palette number 
Output: No output 
Remarks: Two color palettes are available. They have the numbers 0 and 1 and 


contain the following colors: 
Palette 0: Green, red, yellow 
Palette 1: Cyan, magenta, white 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 
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Interrupt 10H, function 0CH BIOS 
Video: Write graphic pixel 


Draws a color pixel at the specified coordinates in graphic mode. 


Input: AH= 0CH 
AL= Pixel color value (see below) 
BH= Graphics page 
CX = Screen column 
DX = Screen line 


Output: No output 


Remarks: The pixel value color parameter depends on the current graphic mode. 
640x200 bitmapped mode only permits the values 0 and 1. In the 
320x200 bitmapped mode, the values 0 to 3 are permitted, which gener- 
ates a certain color according to the chosen color palette. 0 represents the 
selected background color; 1 represents the first color of the selected color 
palette; 2 represents the second color of the color palette, etc. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function O0DH BIOS 
Video: Read graphic pixel 


Reads the color value of a pixel at the specified coordinates in the current graphic 


mode. 
Input: AH= ODH 
DX = Screen line 
CX = Screen column 
Output: AL= Pixel color value 
Remarks: The pixel color value parameter depends on the current graphic mode. 


640x200 bitmapped mode permits the values 0 and 1 only. In the 
320x200 bitmapped mode, the values 0 to 3 are permitted, which gener- 
ates a certain color according to the color palette chosen. 0 represents the 
selected background color; 1 represents the first color of the selected color 
palette; 2 represents the second color of the color palette, etc. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 
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Interrupt 10H, function OEH BIOS 
Video: Write character 


Writes a character at the current cursor position in the current display page. The 
new character uses the color of the character that was previously in this position 


on the screen. 
Input: AH = OEH 
AL= ASCII code of the character 
BL= Foreground color of the character (graphic mode only) 
Output: No output 
Remarks: This function executes control codes (e.g., bell, carriage return) instead of 


reading them as ASCII codes. For example, the function sounds a beep 
instead of printing the bell character. 


After this function displays a character, the cursor position increments so 
that the next character appears at the next position on the screen. If the 
function reaches the last display position, the display scrolls up one line 
and output continues in the first column of the last screen line. 


The foreground color parameter depends on the current graphic mode. 
640x200 bitmapped mode only permits the values 0 and 1. In the 
320x200 bitmapped mode, the values 0 to 3 are permitted, which 
generates a certain color according to the chosen color palette. 0 represents 
the selected background color; 1 represents the first color of the selected 
color palette; 2 represents the second color of the color palette, etc. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 
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Interrupt 10H, function OFH BIOS 
Video: Read display mode 


Reads the number of the current video mode, the number of characters per line and 
the number of the current display page. 


Input: AH= OFH 

Output: AL= Video mode 
0: 40x25 text mode, monochrome (color card) 
1: 40x25 text mode, color (color card) 
2: 80x25 text mode, monochrome (mono card) 
3: 80x25 text mode, color (color card) 
4: 320x200 4-color graphics (color card) 
5: 320x200 4-color graphics (color card) 

(colors represented in monochrome) 

6: 640x200 2-color graphics (color card) 
7: Internal mode (mono card) 


AH = Number of characters per line 
BH= Current display page number 


Remarks: The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


Interrupt 10H, function 13H BIOS (AT only) 
Video: Write character string 


Displays a character string on the screen, starting at a specified screen position on 
a specified display page. The characters are taken from a buffer whose address 
passes to the function. 


Input: AH= 13H 
AL= Output mode (0-3) 
0: Attribute in BL, retain cursor position 
1: Attribute in BL, update cursor position 
2: Attribute in the buffer, retain cursor position 
3: Attribute in the buffer, update cursor position 
BH= Display page number 
BL= Attribute byte of the character (modes 0 and 1 only) 
BP= Offset address of the buffer 
CX = Number of characters to be displayed 
DH = display line 
DL= display column 
ES = segment address of the buffer 


Output: No output 
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Modes 1 and 3 set the cursor position following the last character of the 
character string. On the next call of a BIOS function for character output, 
the next string of characters appears following the original character 
string. This does not occur in the modes 0 and 2. 


In modes 0 and 1, the buffer contains only the ASCII codes of the 
characters to be displayed. The BL register contains the color of the 
character string. However, in modes 2 and 3 each character has its own 
attribute byte when the character is stored in the buffer. The BL register 
doesn't have to be loaded in this mode. Even though the character string is 
twice as long in these modes as the number of the characters to be 
displayed, the CX register requires only the number of ASCII characters 
in the string and not the total length of the character string. 


Control codes (e.g., bell) are interpreted as control codes only, and not as 
characters. 


When the string reaches the last position on the screen, the display scrolls 
upward by one line and output continues in the first column of the last 
screen line. 


The contents of the BX, CX, DX registers and the SS, CS and DS 
segment registers are not affected by this function. The contents of all 
other registers may change, especially the SI and DI registers. 


BIOS 


Determine configuration 


Reads the configuration of the system as recorded during the booting process. 


Input: 
Output: 
PC and XT: 


No input 
AX = Configuration 


Bit 0: 1 if the system has one or more disk drives 
Bit 1: Unused 
Bits 2-3: | RAM available on main circuit board 
00: 16K 
01: 32K 
10: 48K 
11: 64K 
Bits 4-5: Video mode after system boot 
00: Unused 
01: 40x25, color card 
02: 80x25, color card 
03: 80x25, mono card 
Bits 6-7: Number of disk drives in the system if bit 0 is equal to 1 
00: 1 disk drive 
01: 2 disk drives 
10: 3 disk drives 
11: 4 disk drives 
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AT: 


Remarks: 


Interrupt 12H 


Bit 8: 0 when a DMA chip is present 
Bits 9-11: | Number of RS-232 cards connected 
Bit 12: 1 when system has a joystick attached 


Bit 13: Unused 
Bits 14-15: Indicates the number of printers available 


Bit 0: 1 if the system has one or more disk drives 
Bit 1: 1 when a math coprocessor exists in the system 
Bit 2-3: Unused 
Bit 4-5: Video mode during system boot 
00: Unused 
01: 40x25, color card 
02: 80x25, color card 
03: 80x25, mono card 
Bits 6-7: Number of disk drives in the system if bit 0 is equal to 1 
00: 1 disk drive 
01: 2 disk drives 
10: 3 disk drives 
11: 4 disk drives 
Bit 8: Unused 
Bits 9-11: | Number of RS-232 cards connected 
Bit 12-13: Unused 
Bits 14-15: Indicates the number of printers available 


The type of PC must be known (PC, XT or AT) in order to properly 
interpret the meanings of the individual bits of the configuration word. 


The memory size indicated in bits 2 and 3 of the PC/XT configuration 
word refers only to the main circuit board. Interrupt 12H lets you 
determine the total amount of available memory. 

The video mode recorded in bits 4 and 5 is the mode that was activated 
when the system was switched on. To determine the current video mode 
use function 15 of interrupt 10H. 


The contents of the AX register are affected by this function. 


BIOS 


Determine memory size 


Input: 


Output: 


Remarks: 


728 


No input 
AX= Memory size in kilobytes 


The PC and the XT can accept a maximum of 640K of RAM. The AT 
accepts up to 14 megabytes of RAM memory beyond the 1 megabyte 
limit. The memory size returned by this function ignores this extended 
memory. To determine the memory size beyond the 1 megabyte limit, 
use function 88H of interrupt 15H (available only on the AT). 


The contents of the AX register are affected by this function. 
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Interrupt 13H, function 00H BIOS 
Disk: Reset 


Resets the disk controller and any connected disk drives. A reset should be executed 
after each disk operation during which an error occurred. 


Input: AH = 00H 
DL= Oorl 
Output: Carry flag=0: Operation completed (AH=0) 


Carry flag=1: Error (AH=error code) 


Remarks: The value in the DL register is unnecessary since all the disk drives 
execute a reset. XT and AT models use this register to determine whether 
a reset should be performed on the disk drives or the hard disk. 


The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on write protected disk 
04H: Sector not found 

O8H: DMA overflow 

OOH: Data transmission beyond segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, unit not responding 


The contents of the BX, CX, DX, SI, DI, PB registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 01H BIOS 
Disk: Read status 


Reads the status of the disk drive since the last disk operation. 


Input: AH= 01H 
DL= Oor1 
Output: Carry flag=0: Operation completed (AH=0) 


Carry flag=1: Error (AH=error code) 
Remarks: The value in the DL register is unnecessary, since disk drives constantly 


return their status. XT and AT models use this register to determine 
whether the status of the hard disk should be checked. 
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The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on write protected disk 
04H: Sector not found 

O8H: DMA overflow 

09H: Data transmission beyond segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, unit not responding 


The contents of the BX, CX, DX, SI, DI, PB registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 02H BIOS 
Disk: Read disk 


Input: 


Output: 


Remark: 
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Reads one or more disk sectors into a buffer. 


AH= (02H 

AL= Number of sectors to be read 
BX= Offset address of buffer 

CH = Track number 

CL = Sector number 

DH = Disk side number (0 or 1) 
DL= Disk drive number 

ES = Buffer segment address 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The number of sectors to be read into the AL register is limited to sectors 
which logically follow each other on a track on one side of the disk. 
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The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on a write protected disk 
04H: Sector not found 

O8H: DMA overflow 

09H: Data transmission over segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, drive not responding 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all the other 
registers may change. 


Interrupt 13H, function 03H BIOS 
Disk: Write to disk 


Writes one or more sectors to a disk. The data to be transmitted are taken from a 


buffer. 

Input: AH = 03H 
AL= Number of sectors to be written 
BX= Offset address of buffer 
CH = Track number 
CL= Sector number 
DH = Disk side number (0 or 1) 
DL= Disk drive number 
ES = Buffer segment address 

Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 

Remark: The number of sectors that can be written in the AL register is limited to 
sectors which logically follow each other on a track on one side of the 
disk. 


The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on a write protected disk 
04H: Sector not found 
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O8H: DMA overflow 

09H: Data transmission over segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, drive not responding 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 04H BIOS 
Disk: Verify disk sectors 


Compares one or more sectors on disk with the data stored in a buffer. This can be 
used to verify that the data was properly saved to disk. 


Input: AH= 04H 
AL= Number of sectors to be verified 
BX= Offset address of buffer 
CH = Track number 
CL= Sector number 
DH = Disk side number (0 or 1) 
DL= Disk drive number 
ES = Buffer segment address 


Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


Remarks: The number of sectors to be verified in the AL register is limited to 
sectors which logically follow each other on a track on one side of the 
disk. 


The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on a write protected disk 
04H: Sector not found 

O8H: DMA overflow 

O9H: Data transmission over segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, drive not responding 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 13H, function 05H BIOS 
Disk: Format track 


Formats a complete track on one side of a disk. A buffer which contains 
information about the sectors to be formatted must be passed to the function. 


Input: AH = 05H 
AL= Number of sectors to be formatted 
BX= Offset address of buffer 
CH = Track number 
DH = Disk side number (0 or 1) 
DL= Disk drive number 
ES = Buffer segment address 


Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


Remark: The number of sectors to be formatted is limited to sectors which 
logically follow each other on a track on one side of the disk. 


The buffer passed in ES:BX contains an entry consisting of four 
consecutive bytes for every sector to be formatted. 


Track number 
Page number 
Logical sector number 
Number of bytes in this sector: 
0: 128 bytes 
1: 256 bytes 
2: 512 bytes (PC standard) 
3: 1,024 bytes 


fa eee 


The logical sector number increments continuously, but may not be the 
same as the physical sector number. 


The following error codes can occur: 


O1H: Function number not permitted 

02H: Address not found 

03H: Write attempt on a write protected disk 
04H: Sector not found 

O8H: DMA overflow 

OOH: Data transmission over segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, drive not responding 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all the other 
registers may change. | 
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Interrupt 13H, function 15H BIOS (AT only) 
Disk: Determine drive type | 


Senses disk change and drive type. The AT supports both the standard 320/360K 


drives and the 1.2 megabyte drives. 
Input: AH= 15H 
DL= Disk drive number (0 or 1) 
Output: Carry flag=0: Operation completed (AH=unit type) 


AH=0: Device not present 

AH=1: Unit does not recognize disk change 

AH=2: Unit recognizes disk change 

AH=3: Hard disk (see remarks below) 
Carry flag=1: Error 


Remark: The AT has a controller which selectively controls 2 disk drives and a 
hard disk, or one disk drive and 2 hard disks. In the latter case, the first 
hard disk has the number 1 and can be accessed with this function. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 16H BIOS (AT only) 
Disk: Media change 


Senses a disk change. The AT supports both the standard 320/360K drives and the 
1.2 megabyte drives. This function reads any disk change that may have occurred 
since the last disk access. 


Input: AH= 16H 
DL= Disk drive number (0 or 1) 


Output: AH=0: No disk change 
AH=6: Disk changed since last disk access 


Remarks: The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 13H, function 17H BIOS (AT only) 
Disk: Determine disk format 


Determines the format of a disk. The AT's 1.2 megabyte disk drive can read both 
320/360K disks and 1.2 megabyte disks. While the BIOS can determine disk 
format during a read or write access, it first must be informed of the format. 
Function 23 must be called on the AT before you can call function 5 (format). 


Input: AH= 17H 
AL= Format 
AL=1: 320/360K format on 320/360K drive 
AL=2: 320/360K format on 1.2 megabyte drive 
AL=3: 1.2 megabyte format on 1.2 megabyte drive 


Output: Carry flag=0: Operation completed 
Carry flag=1: Error 


Remark: The following error codes can occur: 


01H: Function number not permitted 

02H: Address not found 

03H: Write attempt on a write protected disk 
04H: Sector not found 

O8H: DMA overflow 

O9H: Data transmission over segment border 
10H: Read error 

20H: Error in disk controller 

40H: Track not found 

80H: Time out error, drive not responding 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 13H, function 00H BIOS (XT and AT only) 
Hard disk: Reset 


Resets the hard disk controller and any interfaced hard disk drives. A reset should be 
executed after every hard disk operation during which an error was reported. 


Input: AH= 00H 
DL= 80H or 81H 

Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 

Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


The value in the DL register is unnecessary since all the hard disk drives 
execute a reset. XT and AT models use this register to determine whether 
a reset should be performed on the disk drives or on the hard disk. 


The following error codes can occur: 


O1H: Addressed function or unit not available 
Q2H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: _ Unit not ready 

CCH: Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 01H BIOS (XT and AT only) 
Hard disk: Read disk status 


Reads the status of the hard disk since the last hard disk operation. 


Input: AH= 01H 
DL= 80H or 81H 
Output: Carry flag=0: Operation completed (AH=0) 


Carry flag=1: Error (AH=error code) 
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Remarks: The first hard disk drive is assigned the number 80H, the second is 

assigned the number 81H. 
The value in the DL register is unnecessary since the status is 
consistently returned for each disk drive. XT and AT models use this 
register to determine whether the status of the disk drives or hard disk 
should be checked. 
The following error codes can occur: 

01H: Addressed function or unit not available 

02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

07H: Error during controller initialization 

O9H: DMaA transmission error: Segment border exceeded 

OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: Unit not ready 

CCH: Write error 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of the other 
registers may change. 

Interrupt 13H, function 02H BIOS (XT and AT only) 


Hard disk: Read disk 


Reads one or more hard disk sectors into a buffer. 


Input: 


Output: 


AH = 02H 

AL= Number of sectors to be read (1-128) 
BX= Offset address of buffer 

CH = Cylinder number 

CL = Sector number 

DH = Read/write head number 

DL= Hard disk number (80H or 81H) 

ES = Buffer segment address 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 
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Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Since the eight bits of the CH register can address only 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, which enables the addressing of up to 1,023 
cylinders at a time. 


If several sectors are being read and the system reaches the last sector of a 
cylinder, reading continues at the first sector of the next cylinder of the 
next read/write head. If the system reaches the last read/write head, reading 
continues on the first sector of the following cylinder on the first 
read/write head. 


The following error codes can occur: 


01H: Addressed function or unit not available 
02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

O7H: Error during controller initialization 
O9H: DMaA transmission error: Segment border exceeded 
OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: _ Unit not ready 

CCH: Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 03H BIOS (XT and AT only) 
Hard disk: Write to disk 


Writes one or more sectors to the hard disk. The data to be transmitted are taken 
from a buffer in the calling program. 


Input: AH= 03H 
AL= Number of sectors to be written (1-128) 
BX= Offset address of buffer 
CH = Cylinder number 
CL= Sector number 
DH = Read/write head number 
DL= Hard disk number (80H or 81H) 
ES = Buffer segment address 
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Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Since the eight bits of the CH register can address only 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, enabling the addressing of up to 1,023 cylinders at a 
time. 


If several sectors are being written and the system reaches the last sector 
of a cylinder, writing continues at the first sector of the next cylinder of 
the next read/write head. If the system reaches the last read/write head, 
writing continues on the first sector of the following cylinder on the first 
read/write head. 


The following error codes can occur: 


O1H: Addressed function or unit not available 
02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: _ Unit not ready 

CCH:  Whieerror 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 13H, function 04H BIOS (XT and AT only) 
Hard disk: Verify disk sector 


Verifies one or more sectors of a hard disk. Unlike the corresponding floppy disk 
function, the data on the hard disk are not compared with the data in memory. 
During data storage, four check bytes are stored for every sector; these check bytes 
verify the contents of a sector. 


Input: AH= 04H 
AL= Number of sectors to be verified (1-128) 
BX= Offset address of buffer 
CH = Cylinder number 
CL= Sector number 
DH = Read/write head number 
DL= Hard disk number (80H or 81H) 
ES = Buffer segment address 


Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 

Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Since the eight bits of the CH register can only address 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, which enables the addressing of up to 1,023 
cylinders at a time. 


If several sectors are being verified and the system reaches the last sector 
of a cylinder, verification continues at the first sector of the next cylinder 
of the next read/write head. If the system reaches the last read/write head, 
verification continues on the first sector of the following cylinder on the 
first read/write head. 


The following error codes can occur: 


01H: Addressed function or unit not available 
02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: Unit not ready 

CCH: Write error 
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The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 05H BIOS (XT and AT only) 
Hard disk: Format cylinder 


Formats a complete cylinder (17 sectors) of a hard disk. A buffer, which contains 
information about the sectors to be formatted, must be passed to the function. 


Input: AH= 05H 
AL= 17 
BX= Offset address of buffer 
CH = Cylinder number 
CL= 1 
DH = Read/write head number 
DL= Hard disk number (80H or 81H) 
ES = Buffer segment address 


Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 

Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Since the eight bits of the CH register can only address 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, which enables the addressing of up to 1,023 
cylinders at a time. 


g 
Since a complete cylinder is always formatted, the first sector to be 
formatted in the CL register is always sector 1. For the same reason the 
number of sectors to be formatted in the AL register is always 17, since 
the average hard disk operates with 17 sectors per cylinder. 


The buffer, whose address is passed in ES:BX, must always be at least 
512 bytes long. Only the first 34 bytes of this buffer are used for 
formatting the 17 sectors of a cylinder. Two succeeding bytes contain 
information about the corresponding physical sector. Before the function 
call, the first byte isn't significant. After the function call the first byte 
indicates whether or not the sector could be formatted (OOH) or (80H). The 
second byte returns the logical sector number of the physical sector and 
must be placed in the buffer by calling the program before the function 
call. 
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The following error codes can occur: 


01H: Addressed function or unit not available 
02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 

07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 

10H: Read error 

11H: Read error corrected by ECC 

20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 

AAH: Unit not ready 

CCH: Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 08H BIOS (XT and AT only) 
Hard disk: Check format 


Conveys the formatting information found on the hard disk. 


Input: 


Output: 


Remarks: 
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AH = 08H 

CH = Cylinder number 

CL = Sector number 

DH = Read/write head number (0=first head) 
DL= Hard disk number 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Since the eight bits of the CH register can address only 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, enabling the addressing of up to 1,023 cylinders at a 
time. 


The total capacity of the hard disk unit in bytes can be calculated with the 
following formula: 


Capacity = Heads * Cylinders * Sectors * 512 
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The following error codes can occur: 


Addressed function or unit not available 
Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 
DMaA transmission error: Segment border exceeded 
Defective sector 

Read error 

Read error corrected by ECC 

Controller defect 

Search operation failed 

Time out, unit not responding 

Unit not ready 

Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


BIOS (XT and AT only) 


Hard disk: Adapt to foreign drives 


Interfaces other hard disk drives for access through BIOS functions. 


Input: 


Output: 


Remarks: 


AH = 09H 


DL= Number of hard disk to be interfaced (80H or 81H) 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


BIOS takes the information about the hard disk drive to be interfaced 
(number of units, read/write heads, etc.) from a table. The address of this 
table for the hard disk unit numbered 80H is stored in interrupt vector 
41H, and the unit numbered 81H is stored in interrupt 46H. 


The following error codes can occur: 


Addressed function or unit not available 

Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 

DMaA transmission error: Segment border exceeded 
Defective sector 

Read error 

Read error corrected by ECC 
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20H: Controller defect 

40H: Search operation failed 

80H: Time out, unit not responding 
AAH: Unitnotready 

CCH: Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 0AH BIOS (XT and AT only) 
Hard disk: Extended read 


Reads one or more sectors from the hard disk drive into a buffer. Besides the actual 
512 bytes stored in the sector, the function also reads the four check bytes (ECC). 


Input: 


Output: 


Remarks: 
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AH= 0AH 

AL= Number of sectors to be read (1-127) 
BX= Offset address of buffer. 

CH = Cylinder number 

CL = Sector number 

DH = Read/write head number 

DL= Hard disk number (80H or 81H) 

ES = Buffer segment address 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


Normally the controller computes the four check bytes. Here the buffer 
reads the information direct. 


Since the eight bits of the CH register can only address 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, enabling the addressing of up to 1,023 cylinders at a 
time. 


If several sectors are being read and the system reaches the last sector of a 
cylinder, reading continues at the first sector of the next cylinder of the 
next read/write head. If the system reaches the last read/write head, reading 
continues on the first sector of the following cylinder on the first 
read/write head. 


The following error codes can occur: 


01H: Addressed function or unit not available 
02H: Address not found 

04H: Sector not found 

OSH: Error on controller reset 
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07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 
10H: Read error 
11H: Read error corrected by ECC 
20H: Controller defect 
40H: Search operation failed 
80H: Time out, unit not responding 
AAH: Unit not ready 
CCH: Write error 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
Interrupt 13H, function O0BH BIOS (XT and AT only) 


Hard disk: Extended write 


Writes one or more sectors to the hard disk drive. Besides the actual 512 bytes 
stored in a sector, four check bytes (ECC) stored at the end of every sector are 


transmitted from the buffer. 
Input: AH = 0BH 
AL= Number of sectors to be read (1-127) 
BX= Offset address of buffer 
CH = Cylinder number 
CL = Sector number 
DH = Read/wnite head number 
DL= Hard disk number (80H or 81H) 
ES = Buffer segment address 
Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 
Remarks: The first hard disk drive is assigned the number 80H, the second is 


assigned the number 81H. 


Normally the controller calculates the four check bytes. Here the system 
reads them direct from the buffer. 


Since the eight bits of the CH register can only address 256 cylinders at a 
time, bits 6 and 7 of the CL register (sector number) form bits 8 and 9 of 
the cylinder number, enabling the addressing of up to 1,023 cylinders at a 
time. 


If several sectors are being written and the system reaches the last sector 
of a cylinder, writing continues at the first sector of the next cylinder of 
the next read/write head. If the system reaches the last read/write head, 
writing continues on the first sector of the following cylinder on the first 


read/write head. 
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The following error codes can occur: 


Addressed function or unit not available 
Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 
DMA transmission error: Segment border exceeded 
Defective sector 

Read error 

Read error corrected by ECC 

Controller defect 

Search operation failed 

Time out, unit not responding 

Unit not ready 

Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 0DH BIOS (XT and AT only) 


Hard disk: Reset 


Resets the hard disk controller and any interfaced hard disk drives. A reset should be 
executed after every hard disk operation during which an error was reported. 


Input: — AH= 0DH 


DL= Hard disk drive number (80H or 81H) 


Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


Remarks: The value in the DL register is unnecessary since all the hard disk drives 
execute a reset. XT and AT models use this register to determine whether 
a reset should be performed on the disk drives or on the hard disk. 


This function is identical to function 0 listed above. 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


The following error codes can occur: 


O1H: 
02H: 
04H: 
OSH: 
07H: 
09H: 
OAH: 
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Addressed function or unit not available 

Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 

DMA transmission error: Segment border exceeded 
Defective sector 
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20H: 
40H: 
80H: 


AAH: 
CCH: 
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Controller defect 

Search operation failed 

Time out, unit not responding 
Unit not ready 

Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 10H BIOS (XT and AT only) 


Hard disk: Drive ready? 


Determines if the drive is ready (i.e., the last operation has been completed and the 
drive can perform the next task). 


Input: AH= 10H 


DL= Hard disk drive number (80H or 81H) 


Output: Carry flag=0: Drive ready (AH=0) 
Carry flag=1: Error (AH=error code) 


Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


The following error codes can occur: 


CCH: 


Addressed function or unit not available 
Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 
DMaA transmission error: Segment border exceeded 
Defective sector 

Read error 

Read error corrected by ECC 

Controller defect 

Search operation failed 

Time out, unit not responding 

Unit not ready 

Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 13H, function 11H BIOS (XT and AT only) 
Hard disk: Recalibrate drive 


Recalibrates hard disk after an error occurs, especially after a read or write error. 


Input: AH= 11H 
DL= Hard disk drive number (80H or 81H) 
Output: Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 
Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 
The following error codes can occur: 
01H: Addressed function or unit not available 
02H: Address not found 
04H: Sector not found 
OSH: Error on controller reset 
07H: Error during controller initialization 
O9H: DMA transmission error: Segment border exceeded 
OAH: Defective sector 
10H: Read error 
11H: Read error corrected by ECC 
20H: Controller defect 
40H: Search operation failed 
80H: Time out, unit not responding 
AAH: Unit not ready 
CCH: Write error 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
Interrupt 13H, function 14H BIOS (XT and AT only) 


Hard disk: Controller diagnostic 


Initializes an internal diagnostic test of the hard disk controller. 


Input: 


Output: 


Remarks: 
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AH= 14H 
DL= Hard disk drive number (80H or 81H) 


Carry flag=0: Operation completed (AH=0) 
Carry flag=1: Error (AH=error code) 


The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 
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The following error codes can occur: 


20H: 
40H: 
80H: 
AAH: 
CCH: 


Addressed function or unit not available 
Address not found 

Sector not found 

Error on controller reset 

Error during controller initialization 
DMA transmission error: Segment border exceeded 
Defective sector 

Read error 

Read error corrected by ECC 

Controller defect 

Search operation failed 

Time out, unit not responding 

Unit not ready 

Write error 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 13H, function 15H BIOS (AT only) 
Hard disk: Determine drive type 


Determines whether or not the computer hardware assigned numbers 80H and 81H 
are hard disk drives. The AT contains a controller capable of controlling both hard 
disks and disk drives. This controller can manage either two disk drives and one 
hard disk, or one disk drive and two hard disks. 


Input: AH= 15H 
DL= Hard disk drive number (80H or 81H) 
Output: Carry flag=0: Operation completed (AH=drive type) 
ss Equipment not available 
Drive does not recognize disk change 
; Drive recognizes disk change 
3: Hard disk unit 
Carry flag=1: Error (AH=error code) 
Remarks: The first hard disk drive is assigned the number 80H, the second is 
assigned the number 81H. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 14H, function 00H | BIOS 
Serial port: Initialize 


Initializes and configures a serial port. This configuration includes parameters for 
word length, baud rate, parity and stop bits. 


Input: AH= 00H | 
DX = Number of serial port (O=first serial port, 1=second serial port) 
AL= Configuration parameters 
Bits 0-1: Word length 


10(b) = 7 bits 
11(b) = 8 bits 
Bit 2: Number of stop bits 


0O0(b) = 1 stop bit 
01(b) = 2 stop bits 
Bits 3-4: Parity 
00(b) = none 
01(b) = odd 
11(b) = even 
Bits 5-7: Baud rate 
000(b) = 110 baud 
001(b) = 150 baud 
010(b) = 300 baud 
011(b) = 600 baud 
100(b) = 1200 baud 
101(b) = 2400 baud 
110(b) = 4800 baud 
111(b) = 9600 baud 


Output: AH = Serial port status 
Bit 0: Data ready 
Bit 1: Overrun error 
Bit 2: Parity error 
Bit 3: Framing error 
Bit 4: Break discovered 
Bit 5: Transmission hold register empty 
Bit 6: Transmission shift register empty 
Bit 7: Time out 
AL= Modem status 
Bit 0: Modem ready to send status change 
Bit 1: Modem on status change 
Bit 2: Telephone ringing status change 
Bit 3: Connection to receiver status change 
Bit 4: Modem ready to send 
Bit 5: Modem on 
Bit 6: Telephone ringing 
Bit 7: Connection to receiver modem 


Remarks: ‘The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all the other 
registers may change. 
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Interrupt 14H, function 01H BIOS 
Serial port: Send character 


Sends a character to the serial port. 


Input: AH = 01H 
DX = Number of serial port (O=first serial port, 1=second serial port) 
AL= Character code to be sent 


Output: AH: Bit 7 = 0: Character transmitted 

Bit 7 = 1: Error 

Bit 0-6: Serial port status 
Bit 0: Data ready 
Bit 1: Overrun error 
Bit 2: Parity error 
Bit 3: Framing error 
Bit 4: Break discovered 
Bit 5: Transmission hold register empty 
Bit 6: Transmission shift register empty 


Remarks: The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 

Interrupt 14H, function 02H BIOS 


Serial port: Read character 


Receives a character from the serial port. 


Input: AH = 02H 
DX = Number of serial port (O=first serial port, 1=second serial port) 


Output: AH: Bit 7 = 0: Character received: 

AL = Character received 

Bit 7 = 1: Error: 

Bit 0-6: Serial port status: 
Bit 0: Data ready 
Bit 1: Overrun error 
Bit 2: Parity error 
Bit 3: Framing error 
Bit 4: Break discovered 
Bit 5: Transmission hold register empty 
Bit 6: Transmission shift register empty 


Remarks: This function should only be called if function 3 has determined that a 
character is ready for reception. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


751 


Appendix B: BIOS Interrupts and Functions PC System Programming 


Interrupt 14H, function 03H — . BIOS 
Serial port: Read status 


Reads the status of the serial port. 


Input: AH= 03H 
DX = Number of the serial port (the first serial port has the number 0) 


Output: AH = Serial port status 
Bit 0: Data ready 
Bit 1: Overrun error 
Bit 2: Parity error 
Bit 3: | Framing error 
Bit 4: Break discovered 
Bit 5: Transmission hold register empty 
Bit 6: Transmission shift register empty 
AL= Modem status: 
Bit 0: Modem ready to send status change 
Bit 1: Modem on status change 
Bit 2: Telephone ringing status change 
Bit 3: Connection to receiver status change 
Bit 4: Modem ready to send 
Bit 5: Modem on 
Bit 6: Telephone ringing 
Bit 7: | Connection to receiver modem 


Remarks: This function should always be called before calling function 2 (read 
character). 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 15H, function 83H BIOS (AT only) 
Cassette interrupt: Set flag after time interval 


Sets bit 7 of a flag to 1 after a certain amount of time in microseconds elapses. 
Input: AH= 83H 
ES = Segment address of the flag 
BX= Offset address of the flag 


CX = High word of elapsed time in microseconds 
DX = Low word of elapsed time in microseconds 


Output: No output 
Remarks: A microsecond is a millionth of a second. 
The contents of the BX, SI, DI, BP registers and the segment registers are 


not affected by this function. The contents of all other registers may 
change. 
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Interrupt ISH, function 84H, sub-function 0 BIOS (AT only) 
Cassette interrupt: Read joystick switch settings 


Reads the status of switches on joysticks interfaced to a PC, if game ports and 


joysticks are present. 
Input: AH= 84H 
DxX= 0 
Output: Carry flag=1: No game port connected 


Carry flag=0: Game port present: 

AL = Switch settings: 
Bit 7=1: First joystick's first switch enabled 
Bit 6=1: First joystick's second switch enabled 
Bit S=1: Second joystick’s first switch enabled 
Bit 4=1: Second joystick's second switch enabled 


Remarks: Sub-function 1 reads the joystick position(s). 
The contents of the BX, CX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 15H, function 84H, sub-function 1 BIOS (AT only) 
Cassette interrupt: Read joystick position 


Reads the positions of joysticks interfaced to a PC if game ports and joysticks are 


present. 
Input: AH= 8H 
DxX= 1 
Output: Carry flag=1: No game port connected 


Carry flag=0: Game port present: 
AX = X-position of first joystick 
BX = Y-position of first joystick 
CX = X-position of second joystick 
DX = Y-position of second joystick 


Remarks: Sub-function 0 reads the joystick switch status. 


The contents of the SI, DI, BP registers and the segment registers are not 
affected by this function. The contents of all other registers may change. 
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Interrupt 15H, function 85H BIOS (AT only) 
Cassette interrupt: <Sys Req> key activated 


Responds to pressure or release of the <Sys Req> key. The keyboard routine calls 
this function. 


Input: AH= 85H 
AL= 0: <Sys Req> key depressed 
AL= 1:<Sys Reg> key released 


Output: No output 

Remarks: This function acts as an intermediary for application programs, so that the 
application program will respond appropriately when the user presses the 
<Sys Req> key. 

Interrupt 15H, function 86H : BIOS (AT only) 


Cassette interrupt: Wait 
Returns control to the calling program after a certain amount of time has elapsed. 


Input: AH= 86H 
CX = High word of pause time in microseconds 
DX = Low word of pause time in microseconds 


Output: No output 
Remarks: A microsecond is a millionth of a second. 


The contents of the BX, SI, DI, BP registers and the segment registers are 
not affected by this function. The contents of all other registers may 
change. 


Interrupt 15H, function 87H BIOS (AT only) 
Cassette interrupt: Move memory areas 


Moves areas of RAM from below the 1 megabyte limit to the range above the 1 
megabyte limit, and from above the 1 megabyte limit to below the 1 megabyte 
limit. 


Input: AH= 87H 
CX = Number of words to move 
ES = Segment address of global descriptor table 
SI= Offset address of global descriptor table 


Output: Carry flag=0: No error 
Carry flag=1: Error: 
AH=1: RAM parity error 
AH=2:; Incorrect GDT on function call 
AH=3: Protected mode could not be initialized 
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Remarks: See Section 7.10.1 for more information about the global descriptor table 
(GDT). 


Only words can be transferred; individual bytes cannot be transferred. 


Maximum amount of memory allowed in a transfer is 64K. The value in 
the CX register cannot exceed 8000H. 


All interrupts are disabled during the memory block move. 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 15H, function 88H BIOS (AT only) 
Cassette interrupt: Determine memory size beyond 1 megabyte 


Determines the amount of memory installed beyond the 1 megabyte limit. 


Input: AH= 88H 
Output: AX = Memory size 
Remarks: The value in the AX register represents memory in kilobytes (K). 


Memory size below the 1 megabyte limit can be determined using 
interrupt 12H. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 15H, function 89H BIOS (AT only) 
Cassette interrupt: Switch to virtual mode 


Switches the 80286 processor to virtual mode. 


Input: AH= 89H 
Output: No output © 
Remarks: This function should be called only if you know how virtual mode 


operates. Improper use of this function can easily lead to a system crash. 
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Interrupt 16H, function 00H BIOS 
Keyboard: Read character | 


Reads a character from the keyboard buffer. If the buffer doesn't contain a character, 
the function waits until a character is entered. Then the character is read and 


removed from the keyboard buffer. 
Input: AH = 00H 


Output: AL= (0): Extended key code: 
| AH = Extended key code 
AL>1: Normal key activated: 
AL = ASCII code of key 
AH = Scan code of key 


Remarks: ASCII code definition occurs independent of the keyboard. Scan codes 
apply only to the type of keyboard attached to the PC. See Appendix J for 
a list of ASCII codes and Section 7.11 for a list of extended key codes. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 16H, function 01H BIOS 
Keyboard: Read keyboard for character 


Reads the keyboard buffer for a character ready to be entered. If a character is 
available, the function passes the character to the calling function. The character 
remains in the keyboard buffer and can be re-read when a program calls either 
function 0 (see above) or function 1. The function returns to the calling program 


immediately after the call. 
Input: AH= 01H 
Output: Zero flag = 1: No character in the keyboard buffer 


Zero flag = 0: Character available in keyboard buffer: 
AL = 0: Extended key code: 

AH = Extended key code 
AL>1: Normal key: 

AL = ASCII code of the key 

AH = Scan code of the key 


Remarks: ASCII code definition occurs independent of the keyboard. Scan codes 
only apply to the type of keyboard attached to the PC. See Appendix J for 
a list of ASCII codes and Section 7.11 for a list of extended key codes. 


The contents of the CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 16H, function 02H BIOS 
Keyboard: Read keyboard status 


Reads and returns the status of certain control keys and various keyboard modes. 
Input: AH = 02H 
Output: AL= Keyboard status 


1=NUM LOCK on 
1=CAPS LOCK on 


1=INSERT on 
Keyboard status 
Remarks: The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
Interrupt 17H, function 00H BIOS 


Printer: Write character 


Writes a character to one of the printers interfaced to the PC. 


Input: AH= 00H 
AL= Character code to be printed 
DX = Printer number 


Output: AH = Printer status: 
Bit O=1: Time out error 
Bit 1: Unused 
Bit 2: Unused 
Bit 3=1: Transfer error 
Bit 4=0: Printer offline 
Bit 4=1: Printer online 
Bit 5=1: Printer out of paper 
Bit 6=1: Receive mode selected 
Bit 7=0: Printer busy 


~ 
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Remarks: Parallel port LPT1 is assigned the number 0, parallel port LPT2 is 
assigned the number 1 and parallel port LPT3 is assigned the number 2. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 17H, function 01H BIOS 
Printer: Initialize printer 


Initializes the printer interfaced to the PC. This function should be executed before 
executing function 0 (see above). 


Input: | AH = 01H 
DX = Printer number 
Output: AH = Printer status 
Remarks: Parallel port LPT1 is assigned the number 0, parallel port LPT2 is 


assigned the number 1 and parallel port LPT3 is assigned the number 2. 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 17H, function 02H BIOS 
Printer: Read printer status 


Returns the status of the printer interfaced to the PC. 


Input: AH= 02H 
DX = Printer number 
Output: AH = Printer status 
Remarks: Parallel port LPT1 is assigned the number 0, parallel port LPT2 is 


assigned the number 1 and parallel port LPT3 is assigned the number 2. 
The contents of the BX, CX, DX, SI, DI, BP registers and the segment 


registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 18H BIOS 
Call ROM BASIC 


Accesses BASIC in ROM if a system disk cannot be found during the system 


bootstrap process. 
Input: No input 
Output: No output 
Remarks: Very few PCs or compatibles have built-in ROM BASIC (this is a 


throwback from the early days of the PC). If a PC doesn't have ROM 
BASIC, interrupt 18H returns the system to the calling program. 
However, if the PC does has ROM BASIC, interrupt 18H calls BASIC. 
In most cases, the only way to return to DOS is by warm-starting the 
computer (pressing the <Ctrl><Alt><Delete> keys) or turning the 
computer off and on again. Some versions of ROM BASIC allow an exit 
to DOS by entering the SYSTEM command from BASIC. 


Interrupt 19H BIOS 
Boot process 


Boots the computer. 


Input: No input 

Output: No output 

Remarks: Pressing the <Ctrl><Alt><Delete> keys invokes this interrupt from the 
keyboard. 

Interrupt 1AH, function 00H BIOS 


Date and time: Read clock count 


Reads the current clock count. The clock count increments 18.2 times per second. 
This calculates the time elapsed since the computer was switched on. 


Input: AH= OOH 


Output: CX = High word of the clock count 
DX = Low word of the clock count 
AL= 0: Less than 24 hours have elapsed since the last reading 
AL<>0: More than 24 hours have elapsed since the last reading 
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Remarks: The AT, which has a battery powered realtime clock, sets the clock count 
to the current time when the computer boots. PCs (which don't have 
realtime clocks) set the counter to 0 during booting. 


The contents of the BX, CX, DX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other regis- 
ters may change. 


Interrupt 1AH, function 01H | BIOS 
Date and time: Set clock count 


Sets the contents of the current clock count, which increments 18.2 times per 
second. This calculates the time elapsed since the computer was switched on and 
sets the current time through this function. 


Input: AH= 01H 
CX = High word of clock count 
DX = Low word of clock count 
Output: No output 


Remarks: The AT, which has a battery powered realtime clock, sets the clock count 
to the current time when the computer boots. PCs (which don't have 
realtime clocks) set the counter to 0 during booting. PC owners should 
use this function to set the current time. 


The contents of the AX, BX, CX, DX, SI, DI, BP registers and the 
segment registers are not affected by this function. The contents of all 
other registers may change. 


Interrupt 1AH, function 02H BIOS (AT only) 
Date and time: Read realtime clock 


Reads the time from the realtime clock. 


Input: AH= 02H 

Output: Carry flag = 0: O.K.: 
CH = Hours 
CL= Minutes 
DH = Seconds 


Carry flag = 1: Dead clock battery 
Remarks: All time readings appear in BCD format. 
The contents of the BX, SI, DI, BP registers and the segment registers are 


not affected by this function. The contents of all other registers may 
change. 
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Interrupt 1AH, function 03H BIOS (AT only) 
Date and time: Set realtime clock 


Sets the time on the realtime clock. 


Input: AH= 03H 
CH = Hours 
CL= Minutes 
DH = Seconds 


DL= 1: Daylight Saving Time 
DL= 0: Standard Time 


Output: No output 
Remarks: All time settings must be in BCD format. 
The contents of the BX, SI, DI, BP registers and the segment registers are 


not affected by this function. The contents of all other registers may 
change. 


Interrupt 1AH, function 04H BIOS (AT only) 
Date and time: Read date from realtime clock 


Reads the current date from the realtime clock. 


Input: AH = 04H 
Output: Carry flag = 0: O.K..: 
CH = Century (19 or 20) 
= Year 
DH = Month 
DL= Day 


Carry flag = 1: Dead clock battery 
Remarks: All date readings appear in BCD format. 
The contents of the BX, SI, DI, BP registers and the segment registers are 


not affected by this function. The contents of all other registers may 
change. 
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Interrupt 1AH, function 05H BIOS (AT only) 
Date and time: Set date in realtime clock 


Sets the current date in the realtime clock. 


Input: AH= 05H 
CH = Century (19 or 20) 
CL= Year. 
DH= Month 
DL= Day 
Output: No output 
Remarks: All date settings must be in BCD format. 


The contents of the BX, CX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 1AH, function 06H BIOS (AT only) 
Date and time: Set alarm time 


Sets alarm time for the current day. The alarm time triggers interrupt 4AH. 


Input: AH= 06H 
CH = Hours 
CL= Minutes 
DH = Seconds 
Output: Carry flag=0: O.K. 


Carry flag=1: Dead clock battery or programmed alarm time. 
Remarks: All alarm settings must be in BCD format. 


During booting, interrupt 4AH points to an IRET command. If this 
interrupt doesn't point to a particular routine responding to the alarm, 
nothing will happen once the alarm time is reached. 


Only one alarm time can be active at a time. If another alarm setting 
already exists, you must first delete it by using interrupt 26—1AH, 
function 7 (see below). 


The contents of the BX, CX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 
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Interrupt 1AH, function 07H BIOS (AT only) 
Date and time: Reset alarm time 


Clears an existing alarm setting created by using function 06H above. 


Input: AH = 07H 
Output: No output 
Remarks: This function must be called when you want to change an alarm setting. 


Reset the alarm, then use function 06H to set the new alarm time. 


The contents of the BX, CX, SI, DI, BP registers and the segment 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 1BH BIOS/DOS 
Keyboard: <Break> key pressed 


Records the occurrence of a <Ctrl><Break> key combination and triggers interrupt 
1BH. During the system boot, BIOS sets interrupt 1BH to an IRET command in 
order to prevent any reaction. 


This routine sets a flag to indicate that the user has pressed <Ctrl><Break>. 
Following the execution of one of the DOS functions, this flag is tested for 
character input or output. If the system encounters <Ctrl><Break>, the current 
program stops. In addition, when a batch file is in process, the program asks 
whether the batch file should be continued or terminated. | 


Pressing <Ctrl><C> doesn't activate the interrupt. This key combination forces 
DOS to end the currently executing program. However, the DOS functions for 
Character input/output search for this key combination. 


To prevent termination of an application program, this interrupt can also be 
pointed to a user routine by pressing <Break> or <Ctrl><Break>. 


Input: No input 
Output: No output 
Remarks: Before returning control to the calling program, this interrupt must 


restore all registers to their previous values. 
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Interrupt 1CH BIOS 
Periodic interrupt 


The timer IC calls interrupt 8H approximately 18.2 times per second. After ending 
its task, it calls interrupt 1CH in order to allow an application program access to 
the signals from the timer IC. During booting, BIOS initializes the interrupt 
vector of interrupt 1CH so that it points to an IRET command, which prevents 
any response if the interrupt is called. For example, this interrupt can be pointed to 
a user routine to create a constant display clock on the screen. 


Input: No input 
Output: No output 
Remarks: This interrupt must restore all registers to their previous values before 


returning control to the calling program. 


Interrupt IDH BIOS 
Video table 


Sets a pointer to a table. The vector of this interrupt in the vector table, starting at 
address 0000:0074, stores the offset and segment address of this table. The table 
itself contains a collection of parameters used by BIOS for initializing a certain 
video mode. This involves the 16 memory locations on the video card, whose heart 
is a 6845 video processor. For this reason the table to which the vector points and 
which is part of the ROM-BIOS, consists of 16 consecutive bytes that indicate the 
contents of individual registers for a certain video mode. The first of these 16 bytes 
is copied into the first register of the 6845, the second byte into the second 
register, etc. The table in ROM contains a total of four 16-byte entries: 40x25 
color mode, 80x25 color mode, 80x25 monochrome mode and one entry for the 
various color graphics modes. 


Do not call this interrupt. If you do, the system will attempt to read the video 
table as executable code and will crash. 


Input: No input 
Output: No output 
Interrupt 1EH BIOS/DOS 


Drive table 


Sets a pointer to a table. The vector of this interrupt in the vector table starting at 
address 0000:0078 stores the offset and segment address of this table. The table 
itself contains a collection of parameters used by BIOS in disk drive access. BIOS 
has a table in ROM, but deviates the interrupt vector of interrupt 30 to its own 
table which allows faster disk access than the BIOS table (see Section 7.7 for more 
information about this table). 
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Do not call this interrupt. If you do call it, the system will attempt to read the 
drive table as executable code and will crash. 


Input: No input 
Output: No output 
Interrupt 1FH BIOS/DOS 


Character table 


Sets a pointer to a table. The vector of this interrupt in the vector table, starting at 
address 0000:007C, stores the offset and segment address of this table. The table 
itself contains character patterns for the characters possessing ASCII codes 128 to 
255. BIOS needs this table in order to display the graphic mode characters on the 
screen. These characters are displayed by placing the character patterns, which are 
Stored in this table, on the screen as individual pixels. 


Since the character patterns for codes 0 to 127 are already stored in a table in 
ROM-BIOS, this table contains only the character patterns for codes 128 to 255. 
The DOS GRAFTABL command loads a table for codes 127 to 255 into RAM and 
points the interrupt vector of interrupt 31 to this table. A user table can be added to 
display on the screen, in graphic mode, certain characters that are not part of the 
normal PC character set. The construction of the table requires that eight 
consecutive bytes define the appearance of the character. The first eight bytes of the 
table define the appearance of ASCII code 128, the next eight bytes define ASCII 
code 129, etc. Each set of eight bytes represent the eight lines which denote a 
character in graphic mode. The eight bits of each byte indicate the eight columns 
of pixels for each line. 


Do not call this interrupt. If you do call it, the system will attempt to read the 
character table as executable code and will crash. 


Input: No input 


Output: No output 
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Function Description _. Page Number 


Interrupt 20H | 


Terminate program ...............ccccscssscscscsccscoceeees 773 


Interrupt 21H functions—arranged by function groups 


Character input 


Function 


01H 
03H 
06H 
07H 


08H 
OAH 
0OBH 
0CH 


Character output 
i 
02H 
04H 
OSH 
06H 
09H 


Program termination 


00H 
31H 
4CH 


Description Page Number 
Character input with echo (Ver. 1 and up)................. 773 
Auxiliary input (Ver. 1 and up)....................eeeesseeees 775 
Direct console I/O (Ver. 1 and up)..............sscsecsseeee 776 
Unfiltered character input without echo 

CV Gr. TANG ID) sescvacecccesantecdedacesweecaseatincyoteeeccunt 777 
Character input without echo (Ver. 1 and up)............. 778 
Buffered input (Ver. 1 and up)...............sccssssssscssoees 7719 
Get input status (Ver. 1 and up)..............csscscsesscneees 780 
Reset input buffer and then input (Ver. 1 and up)....... 780 

Num 
Character output (Ver. 1 and up) ..............secsecseeseeees 7714 
Auxiliary output (Ver. 1 and up)..............scssecsseseeoes ITO 
Printer output (Ver. 1 and up)...............cccccssssscscses 7716 
Direct console I/O (Ver. 1 and up).............sscescssceeees 7716 
Output character string (Ver. 1 and up)................0666 778 
m 

Terminate program (Ver. 1 and up)...........cs.cssceesesees 773 
Terminate and stay resident (Ver. 2 and up)............... 799 
Terminate with return code (Ver. 2 and up)................ 825 
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i ipti 
39H Create subdirectory (Ver. 2 and up)..............sccsseseeees 804 
3AH Delete subdirectory (Ver. 2 and up).............ssssececssees 805 
3BH Set current directory (Ver. 2 and up)...............cccccceees 805 
47H Get current directory (Ver. 2 and up) .............ceecseseees 821 
RAM control 
48H Allocate memory (Ver. 2 and up) ............sssssssessceeses 821 
49H Release memory (Ver. 2 and up) ............s.ssescsessccsees 822 
4AH Modify memory allocation (Ver. 2 and up)................ 822 
58H Get allocation strategy (sub-function 0) 
CV CFs S ONG UD) avspaccyovsscrssscncsoadeedoncasbadiseedennta haan’ 830 
58H Set allocation strategy (sub-function 1) 
(Ver 3 ANd OD) widieveccediers Seiden eaandaiotenss 830 
Device driver access 
Function Description Page Number 
44H IOCTL: Get device info (sub-function 0) 
(Ver. 2 Amd UD) osssstvezsciceneescosseasiasedestastebecauseeess ees 813 
44H IOCTL: Set device info (sub-function 1) 
CVE 2 ANG UD) sac rescenerccaveuesencdbnsetenccctucketaueenese seus 813 
44H IOCTL: Read data from character device 
(sub-function 2) (Ver. 2 and up)................sccesececeeeee 814 
44H IOCTL: Send data to character device 
(sub-function 3) (Ver. 2 and Up)...........csesescsscsceeeeees 815 
44H IOCTL: Read data from block device 
(sub-function 4) (Ver. 2 and up).............cesscecseseeeees 816 
44H IOCTL: Send data to block device 
(sub-function 5) (Ver. 2 and up)............sscescsccsescecees 816 
44H IOCTL: Read input status 
(sub-function 6) (Ver. 2 and up)...........sscescceeceesscees 817 
44H IOCTL: Read output status 
(sub-function 7) (Ver. 2 and Up)............ccccsseceecseeeces 817 
44H IOCTL: Test for changeable block device 
(sub-function 8) (Ver. 3 and Up)...........csecsesseecsceeees 818 
44H IOCTL: Test for local or remote drive 
(sub-function 9) (Ver. 3.1 and up) ..............ccecceseseees 818 
44H IOCTL: Test for local or remote handle 
(sub-function 10) (Ver. 3.1 and up).................cceeeee 819 
44H IOCTL: Change retry count 
(sub-function 11) (Ver. 3 and up) .............csessesseeeeees 819 
Time and date 
ncti ripti Ni r 
2AH Get system date (Ver. 1 and up) ...............ccccsscsesecees 7196 
2BH Set system date (Ver. 1 and up).............ccsccssssssrseeees 7197 
2CH Get system time (Ver. 1 and up)..............csessecsceecees 797 
2DH Set system time (Ver. 1 and up)..............csccssssrreeees 797 
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DTA 
F ' D a Page Num! 
1AH Set DTA address (Ver. 1 and up) ............ssescsssssesssees 788 
2FH Get DTA address (Ver. 2 and up)............cececcsscssoesees 798 


Search directory 


11H Search for first matching directory FCB 

CV CF. LUANG UD) cc aceccesecuscacsvescossctiensstvetuasmenadevesees 783 
12H Search for next matching directory FCB 

Vets TONG Up) seescocctit iieeseeiess Shiv aces eats 783 
4EH Search for first matching directory FCB 

CV CL-2 ANG UD) cs. sruseacccasiseivereusveacesardsencanceeuveeoases 826 
4FH Search for next matching directory handle 

CV Efe 2 ANG UD) veresewserctsvesnessseacevessevasasasiuccnodendeins. 827 

File access (FCB) 
nction Descripti 
OFH Open file (FCB) (Ver. 1 and up)...............ccccccceceeees 782 
10H Close file FCB) (Ver. 1 and up)................sscesecssceee 102 
13H Delete file (FCB) (Ver. 1 and up) ...............csceesseeeeee 784 
14H Sequential read (FCB) (Ver. 1 and up) ................ec0e0 786 
15H Sequential write (FCB) (Ver. 1 and up).................006 786 
16H Create or truncate file (FCB) (Ver. 1 and up)............. 786 
17H Rename file (FCB) (Ver. 1 and up)..............cccscseesees 787 
21H Random read (FCB) (Ver. 1 and up).............ccccsceceees 790 
22H Random write (FCB) (Ver. 1 and up).................s0008. 791 
23H Get file size in records (FCB) (Ver. 1 and up)............ 792 
24H Set random record number (Ver. 1 and up)................ 792 
27H Random block (FCB) (Ver. 1 and up)................cscce0 794 
28H Random block write (FCB) (Ver. 1 and up)............... 795 
29H Parse filename to FCB (Ver. 1 and up)...............c0c00. 795 
File access (handle) 

Function _ Description === Page Number 
3CH Create or truncate file (handle) (Ver. 2 and up)........... 806 
3DH Open file (handle) (Ver. 2 and up)..................ccsseeees 807 
3EH Close file (handle) (Ver. 2 and up)..............csscsseeseees 808 
3FH Read file or device (handle) (Ver. 2 and up)................ 808 
40H Write to file or device (handle) (Ver. 2 and up)........... 809 
41H Delete file (handle) (Ver. 2 and up) ..............sceseseseees 810 
42H Move file pointer (handle) (Ver. 2 and up)................. 810 
45H Duplicate handle (Ver. 2 and up) .............csecsecscsceeees 820 
46H Force duplicate of handle (Ver. 2 and up) ...............0 820 
5AH Create temporary file (handle) (Ver. 3 and up)............ 834 
56H Rename file (handle) (Ver. 2 and up)............csceseseeees 828 
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Interrupt vectors 


25H Set interrupt vector (Ver. 1 and up).............scccccsseees 793 
35H Get interrupt vector (Ver. 2 and up) ...................c0eee+ 801 


Disk/hard disk access 
F ; , ee: Page Numi 


0DH Disk reset (Ver. 1 and Up)............csscsecssceecsesescsceeees 781 
0EH Set default disk drive (Ver. 1 and up)...............scccccee 781 
19H Get default disk drive (Ver. 1 and up) .............cssceseees 788 
1BH Get allocation information for default drive 
CV Cr PONG UD) da onsauicraraveiacoceentosexsesedhetacsasiedausees 789 
1CH Get allocation information for specified drive 
(VOG.2 BND) ss cvsswesvucec edsdessaconsevcdusus eitetacadabaeact 789 
36H Get free disk space (Ver. 2 and up)..............ccsesesseeee 801 
PSP access 
Function __Description Page: Number 
26H Create PSP (Ver. 1 and up)..............sscescsccseecsceseeees 793 
62H Get PSP address (Ver. 3 and up)..............sccccccceseoes 839 
DOS flag access 
ion Descripti m 
2EH Set verify flag (Ver. 1 and up) ...............sscesecoeesceeees 798 
33H Get <Ctrl><Break> flag (sub-function 0) ................. 800 
33H Set <Ctrl><Break> flag (sub-function 1) ................. 800 
54H Get verify flag (Ver. 2 and up) 
File information access 
Functio Description Page Number 
43H Get file attributes (sub-function 0) (Ver. 2 and up)......811 
43H Set file attributes (sub-function 1) (Ver. 2 and up)...... 812 
57H Get file date and time (sub-function 0) (Ver. 2 and up).829 
57H Set file date and time (sub-function 1) (Ver. 2 and up). 829 
Country-specific functions 
Function __Description «Page Number 
38H Get country (Ver. 2 and Up)..............ccssssscssssssreeeees 802 
38H Get country (sub-function 0) (Ver. 3 and up)............. 802 
38H Set country (sub-function 1) (Ver. 3 and up).............. 804 
Other functions ' 
Function Description Page Number 
30H Get MS-DOS version number (Ver. 2 and up)........... 799 
4BH Execute program (sub-function 0) (Ver. 2 and up).......823 
4BH Execute overlay program (sub-function 3) ................ 824 
4DH Get return code (Ver. 2 and up) ..............csccssecscesseees 826 
59H Get extended error information (Ver. 3 and up)........... 831 
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Interrupt 
Interrupt 
Interrupt 


Interrupt 


Interrupt 
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22H Terminate address ............csccccccsscsccssseessceseescees 841 
23H <Ctril><C> handler address..............cc.csscscceees 841 
24H Critical error handler address...................s0000 842 
25H Absolute disk read...............cccccsccsscsscessscssessoes 843 
26H Absolute disk Wite..............cccsccsscsscsecscsscsseees 844 
27H Terminate and stay resident .................ccsccseees 845 
2FH Print spooler 
n 
00H Get print spooler install status................scsssssssssesees 846 
01H Send file to print Spooler...............ccsccsscecssesccseescees 846 
02H Remove file from print QUeuc...............csscssscsecsseeeee 847 
03H Cancel all files] in print QUeuc...................cccscesceeees 847 
04H Hold print job for status Check...............cccccccccccsssees 846 
21H functions—arranged by function numbers 
1 ripti m 
00H Program terminate (Ver. 1 and up).............sssccssceesees 773 
01H Character input with echo (Ver. 1 and up)................. 7714 
02H Character output (Ver. 1 and up) ..............sscssseseeseees 774 
03H Auxiliary input (Ver. 1 and up)...............cccccccccsseeees 7715 
04H Auxiliary output (Ver. 1 and up)..............csscsscesceenes TTS 
05H Character output to printer (Ver. 1 and up)................ 716 
06H Direct character input/output (Ver. 1 and up)............. 7716 
07H Unfiltered character input without echo (Ver. 1 and up)777 
08H Character input without echo (Ver. 1 and up)............. 778 
09H Output character string (Ver. 1 and up)............cssceceee 778 
OAH Buffered input (Ver. 1 and up)............ccssccscccsssseeeees 7719 
0BH Get input status (Ver. 1 and up)...............ccssssesssesees 780 
OCH Reset input buffer and then input (Ver. 1 and up)....... 780 
0DH Disk reset (Ver. 1 and up)...........s.cssscssccsccescsscssesees 781 
0OEH Set default disk drive (Ver. 1 and up).............cccsssseee 781 
OFH Open file (FCB) (Ver. 1 and up)................csccecsseeeees 782 
10H Close file (FCB) (Ver. 1 and up)..............sscscessesseees 782 
11H Search for first match (FCB) (Ver. 1 and up)............. 783 
12H Search for next match (FCB) (Ver. 1 and up)............. 784 
13H Delete file (FCB) (Ver. 1 and up) ..............cssccessceeees 784 
14H Sequential read (FCB) (Ver. 1 and up) .............ceceseeee 785 
15H Sequential write (FCB) (Ver. 1 and up)..................04 786 
16H Create or truncate file (FCB) (Ver. 1 and up)............. 786 
17H Rename file (FCB) (Ver. 1 and up)...............ceccsceeees 787 
19H Get default disk drive (Ver. 1 and up) ................ecceees 788 
1AH Set DTA address (Ver. 1 and up) ..............ssccscsecseeees 788 
1BH Get allocation information for default drive 
CV GE TANG UP) vince corabavasasanacberawavassioatiasdatenasnceces 789 
1CH Get allocation information for specified drive 
CVEL ZANT UD) aisdsiccssevedanbesesceectnudessetnessonieeeeesens 789 
21H Random read (FCB) (Ver. 1 and up)............sscsscsceeees 790 
22H Random write (FCB) (Ver. 1 and up) ..............csceeeees 791 
23H Get file size in records (FCB) (Ver. 1 and up)............ 792 
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Set random record number (Ver. 1 and up).............00¢ 792 
Set interrupt vector (Ver. 1 and up)...............cccssseeees 793 
Create PSP (Ver. Land Up) siicsccsccnsavercacenssscnesatenin te 793 
Random block read (FCB) (Ver. 1 and up)................. 794 
Random block write (FCB) (Ver. 1 and up)............... 795 
Parse filename to FCB (Ver. 1 and up)...............0se08 795 
Get system date (Ver. 1 and up) ................cscsecseceeees 796 
Set system date (Ver. 1 and up).................ssseeseseseees 797 
Get system time (Ver. 1 and up) ...............sccseseeeseees 797 
Set system time (Ver. 1 and up)..................ccccessseees 797 
Set verify flag (Ver. 1 and up) ..............ccsceseseeeeeeees 798 
Get DTA address (Ver. 2 and up)..............ccsecssseseeses 798 
Get MS-DOS version number (Ver. 2 and up)........... 799 
Terminate and stay resident (Ver. 2 and up)............... 799 
Get <Ctrl><Break> flag (sub-function 0) 

CV GE 2 ANd UD) dicicoesiasessseteedsn ecnrciocsasteae pines 800 
Set <Ctrl><Break> flag (sub-function 1) 

CV et. 2 ANG AID) scsceconsecsyscegstunwl se ake vine daebinteneputseaves 800 
Get interrupt vector (Ver. 2 and Up) ..............sssssseeees 801 
Get free disk space (Ver. 2 and up)...............csscesssees 801 
Get country (Ver. 2 and Up)..............csssssccccecccceceeees 802 
Get country (sub-function 0) (Ver. 3 and up)............. 802 
Set country (sub-function 1) (Ver. 3 and up).............. 804 
Create subdirectory (Ver. 2 and up).............cssesessesees 804 
Delete subdirectory (Ver. 2 and up).............ccseescseeses 805 
Set current directory (Ver. 2 and up)............scccsssseees 805 
Create or truncate file (handle) (Ver. 2 and up)........... 806 
Open file (handle) (Ver. 2 and up)..............ccssccsssseees 807 
Close file (handle) (Ver. 2 and up)..............cscscsssseees 808 
Read file or device (handle) (Ver. 2 and up)................ 808 
Write to file or device (handle) (Ver. 2 and up)........... 809 
Delete file (handle) (Ver. 2 and up) ...............secsseseees 810 
Move file pointer (handle) (Ver. 2 and up)................. 810 
Get file attributes (sub-function 0) (Ver. 2 and up)......811 
Set file attributes (sub-function 1) (Ver. 2 and up)...... 812 
IOCTL: Get device info (sub-function 0) 

CV GTZ ANC UD) cea cssevsscsereusesicveaveustccnreaseaaioseeeeds 813 
IOCTL: Set device info (sub-function 1) 

CVGI. 2 ANd UD) aiccscecestacecesetaiossserseraem shescmeueew tes 813 
IOCTL: Read data from character device (sub-function 2) 
CVG. 2 ANG UD) oc ciswcsessadincedsnss vem wncistnenieecotessesen 814 
IOCTL: Send data to character device (sub-function 3) 
(VCE 2 ANG UD) ti ecistetis ese ao reece 815 
IOCTL: Read data from block device (sub-function 4) 

CV GF ANd UD Pas sana hicriw ieee Asc eew sateen eats uaxenss 816 
IOCTL: Send data to block device (sub-function 5) 

CVGL DANG UD) sacosvedenscccsscveceutevastetecs sve cqeubereoucetons 816 
IOCTL: Read input status (sub-function 6) 

CV GIs 2 ANG UD) scsexescicdeoutectativoseaceisesiseuiee senses 817 


Appendix C: DOS Interrupts and Functions 


PC System Programming 


772 


aan 
44H 
44H 
44H 
44H 


45H 
46H 
47H 
48H 
49H 
4AH 
4BH 
4BH 
4CH 
4DH 
4EH 
4FH 
54H 
56H 
57H 
57H 
58H 


58H 


59H 
SAH 
SBH 
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Interrupt 20H DOS 
Terminate program (Version 1 and up) 


Input: 


Output: 


Restores the three interrupt vectors whose contents were stored in the PSP before 
the program call, terminates the currently running program and returns control to 
MS-DOS. If the program redirected the vectors to its own routine, these vectors 
cannot be overwritten by another program. However, the terminating program 
releases the RAM it had occupied. Before turning control over to the calling 
program, this memory releases and all data buffers clear. 


CS = Segment address of the PSP 


No output 


Remarks: COM programs automatically store the segment address of the PSP in the 


CS register. EXE programs require additional programming to load the 
segment address of the PSP into the CS register. Since the code and the 
PSP are stored in two separate segments, the address of the PSP must be 
loaded into the CS register. The code executes from another segment, 
which makes it impossible to call interrupt 32. To help overcome this 
problem, the value 0 and then the segment address of the PSP are pushed 
onto the stack. If a FAR RETURN command then executes, the program 
execution continues in the PSP segment at offset address 0. There a call 
for interrupt terminates the program. 


For the first version of DOS, this interrupt is the usual method for ending 
a program. To terminate a program in DOS Version 2 and up, functions 
31H or 4CH of DOS interrupt 21 H should be called instead. 


Interrupt 21H, function 00H DOS 
Terminate program (Version 1 and up) 


Input: 


Output: 


Terminates execution of the currently running program and returns control to the 
calling program. Before this happens, the three interrupt vectors, whose contents 
had been stored in the PSP before the call of the program, are restored. If the 
program redirects these vectors to its own routine, they cannot be overwritten by 
another program. However, the terminating program does release the RAM it had 
occupied. Before turning control over to the calling program, the function releases 
this memory and clears all buffers. 


AH= 00H 
CS = segment address of the PSP 


No output 


Remarks: COM programs automatically store, in the CS register, the segment 


address of the PSP. Since the code and the PSP are stored in two separate 
segments, you cannot execute this function from an EXE program. 
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Instead of this function, use either function 31H or 4CH of interrupt 21H 


for terminating a program. 
Interrupt 21H, function 01H DOS 
Character input with echo (Version 1 and up) 


Reads a character from the standard input device and displays it on the standard 
output device. When the function is called but a character doesn't exist, the 
function waits until a character is available. Since standard input and output can be 
redirected, this function is able to read a character from an input device other than 
the keyboard and send it to an output device other than the screen. The characters 
that are read may originate from other devices or from a file. If the character comes 
from a file, the input doesn't redirect to the keyboard once it reaches the end of the 
file. So, the function continues to try to read data from the file after it passes the 


end. 

Input: AH = 01H 

Output: AL = Character read 

Remarks: If extended key codes are read, the function passes code 0 to the AL regis- 
ter. The function must be called again to read the actual code. 
If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 
The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 

Interrupt 21H, function 02H DOS 

Character output (Version 1 and up) 


Displays a character on the standard output device. Since this device can be 
redirected, the character can be displayed on another output device or sent to a file. 
This function doesn't test whether or not the storage medium (disk or hard disk) is 
already full. Therefore, it will continue to try to write characters to this file. 


Input: AH= 02H 
DL= code of the character to be output 
Output: No output 
Remarks: Control codes such as backspace, carriage return and linefeed are executed 


when the function sends characters to the screen. If the output is redirected 
to a file, control codes are stored as normal ASCII codes. 


If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 
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The contents of the processor registers and the flag registers are not 


affected by this function. 
Interrupt 21H, function 03H DOS 
Read character auxiliary input (Version 1 and up) 


Reads a character from the serial port. Access defaults to the device with the 
designation COM1, unless a MODE command previously redirected serial access. 


Input: AH= 03H 
Output: AL= Character received 
Remarks: Since the serial port has no internal buffer, it can receive characters faster 


than it can read them. The unread characters are then ignored. 


Before calling this function, communication parameters (baud rate, 
number of stop bits, etc.) must be set using the MODE command. 
Otherwise DOS defaults to 2400 baud, one stop bit, no parity and a word 
length of 8 bits. 


The BIOS functions called from interrupt 14H are a more efficient way to 
access the serial port. Since they also allow reading of the serial port 
status, these functions offer more flexibility than the DOS functions. 


If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 04H DOS 
Auxiliary output | (Version 1 and up) 


Sends a character to the serial port. Unless a MODE command previously 
redirected serial access, access defaults to the device with the designation COM1. 


Input: AH = 04H 
DL= Character set for output 

Output: No output 

Remarks: As soon as the receiving device sends a signal to the function indicating 
that it is ready to receive it, the function transmits the character. Control 
then returns to the calling program. 


Before calling this function, communication parameters (baud rate, 
number of stop bits, etc.) must be set using the MODE command. 
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Otherwise DOS defaults to 2400 baud, one stop bit, no parity and a word 
length of 8 bits. 


The BIOS functions called from interrupt 14H are a more efficient way to 
access the serial port. Since they also allow reading of the serial port 
status, they offer more flexibility than the DOS functions. 


If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 


interrupt 23H. 
The contents of the processor registers and the flag registers are not 
affected by this function. 
Interrupt 21H, function 05H DOS 
Character output to printer (Version 1 and up) 


Sends a character to the printer. Access defaults to the device with the designation 
LPT 1 (identical to PRN), unless a MODE command previously redirected printer 


access. 
Input: AH= 05H 
DL= Character code to be printed 
Output: No output 
Remarks: The function transmits the character only when the printer signals that it 
is ready to receive it. Then control returns to the calling program. 
If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 
The BIOS functions called from interrupt 17H are more efficient for 
printer access. They offer more flexibility than the DOS printer functions 
for character output. 
The contents of the processor registers and the flag registers are not 
affected by this function. 
Interrupt 21H, function 06H DOS 
Direct console I/O | (Version 1 and up) 


Reads characters from the standard input device and displays them on the standard 
output device. The read or written character isn't tested by the operating system 
(e.g., <Ctrl><C> has no effect on the program). Since standard input and output 
can be redirected, this function can read a character from an input device other than 
the keyboard and sends it to an output device other than the screen. The characters 
read may originate from other devices or from a file. When writing characters, this 
function doesn't test whether or not the storage medium (disk or hard disk) is 
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Input: 


Output: 


already full. Also, the calling program cannot determine whether all the characters 
have been read from an input file. 


During character input, the function doesn't wait until a character is available. 
Instead, the function returns control to the calling program. 


AH = 06H 
DL= 0-254: Send character code 
DL= 255: Read a character 


Character output: No output 
Character input: Zero flag=1: No character ready 
Zero flag=0: Character read is in the AL register 


Remarks: If extended key codes are read, the function passes code 0 to the AL regis- 


ter. The function must be called again to read the actual code. 


ASCII code 255 (blank) cannot be displayed with this function because 
the function interprets ASCII code 255 as a command to input a character. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 07H DOS 
Unfiltered character input without echo (Version 1 and up) 


Input: 


Output: 


Reads a character from the standard input device without displaying the character on 
the standard output device. If a character doesn't exist when the function is called, 
the function waits until a character is available. The read character is not tested by 
the operating system (e.g., <Ctrl><C> has no effect on the program). Since 
standard input and output can be redirected, this function can read a character from 
an input device other than the keyboard. The characters that are read may originate 
from other devices or from a file. If the characters come from a file, the input 
doesn't redirect to the keyboard once it reaches the end of file. This causes the 
function to continue to try reading data from the file after it passes the end of file. 


AH = 07H 
AL= Character read 


Remarks: If extended key codes are read, the function passes code 0 to the AL regis- 


ter. The function must be called again to read the actual code. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 08H DOS 
Character input without echo (Version 1 and up) 


Reads a character from the standard input device without displaying the character on 
the standard output device. If no character exists when the function is called, the 
function waits until a character is available. 


Since standard input can be redirected, this function can read a character from an 
input device other than the keyboard. The characters read may originate from other 
devices or from a file. If the characters come from a file, the input doesn't redirect 
to the keyboard on reaching the end of file, so the function continues to try reading 
data from the file after it passes the end of file. 


Input: AH = 08H 
Output: AL= Character read 
Remarks: If extended key codes are read, the function passes code 0 to the AL regis- 


ter. The function must be called again to read the actual code. 


If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 09H DOS 
Output character string (Version 1 and up) 


Displays a character string on the standard output device. Since this device can be 
redirected, the character may be displayed on another output device or sent to a file. 
This function doesn't test whether or not the storage medium (disk or hard disk) is 
already full, and will continue to try to write the string to a file. 


Input: AH = 09H 
DS = String segment address 
DX = String offset address 
Output: No output 


Remarks: The string must be stored in memory as a series of bytes which contain 
the ASCII codes of the characters to be output. A dollar sign character "$" 
(ASCII code 36) indicates, to DOS, the end of the string. 


Control codes, such as backspace, carriage return and linefeed, are executed 
within the string. 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 0AH DOS 


Buffered input 


(Version 1 and up) 


Reads a number of characters from the standard input device and transmits the 
characters to a buffer. The input ends when the user presses the <Return> key. The 
ASCII code of this key (13) is then placed in the buffer as the last character of the 


string. 


Since standard input can be redirected, this function can read a character from an 
input device other than the keyboard. The characters read may originate either from 
other devices or from a file. If the characters come from a file, the input doesn't 
redirect to the keyboard on reaching the end of file, so the function continues to try 
reading data from the file after it passes the end. 


Input: 


Output: 
Remarks: 


AH = 0AH 
DS = Buffer segment address 
DX = Buffer offset address 


No output 


The first byte of the buffer accepts the maximum number of characters 
(including the carriage return which ends the input) which can be read into 
the buffer, starting at memory location 2. In order to inform the function 
of the maximum number of characters it may read, this information must 
be entered, by the calling program, into the buffer before the function 
call. 


After completion of the input, DOS places the number of characters read 
(excluding the carriage retum) in memory location 1. 


The buffer must be the number of the characters to be read plus 2 bytes. 


When the input reaches the second to last memory location in the buffer, 
the computer beeps if you attempt to enter any character other than the 
<Return> key (end of input). 


Extended key codes occupy two bytes in the buffer. The first byte 
contains the code 0, and the second byte contains the extended key code. 


If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 


The <Backspace> and cursor keys let you edit the input without storing 
these keys in the buffer. 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 0BH DOS 
Get input status (Version 1 and up) 


Determines whether a character is available for reading from the standard input 


device. 

Input: AH = OBH 

Output: AL= 0: No character available 
AL= 255: One or more characters available for reading 

Remarks: If the function encounters a <Ctrl><C> character (ASCII code 3), it calls 
interrupt 23H. 
The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 

Interrupt 21H, function 0CH DOS 

Reset input buffer and then input (Version 1 and up) 


Clears the input buffer then calls one of the character input functions. Since all the 
character input functions get their characters from the standard input device and 
standard input may redirected, this function only operates when the keyboard is the 
standard input device. In this case the characters could be entered before the 
function call but not read by a function. These existing characters are erased to 
ensure that the function call only reads characters which were inputted after its call. 


Input: AH= OCH 
AL= Function to be called during call of function 10 
DS = Input buffer segment address 
DX = Input buffer offset address 


Output: Functions 1, 6, 7 and 8: AL = Character to be read 
Function 10: No output 

Remarks: Functions 1, 6,7, 8 and 10 can be passed to the function as calling func- 
tions. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function ODH DOS 
Disk reset (Version 1 and up) 


Sends all data stored in an internal DOS buffer to a block driver device (e.g., disk 
drive, hard disk). The open files (handles or FCBs) remain open. 


Input: AH = QDH 
Output: No output 
Remarks: Despite this function call, all open files must be closed in an orderly 


manner. Otherwise the current directory entry of the file may not update 
properly, which prevents access to new file data. 


The contents of the processor registers and the flag registers are not 


affected by this function. 
Interrupt 21H, function 0EH DOS 
Select default disk drive (Version 1 and up) 


Defines the the current default disk drive. Its designation appears as a prompt on 
the screen when the command interpreter expects input from the user. The drive 
indicated here will be used for all file access in which no special device was 


specified. 
Input: AH= 0OEH 
DL= Drive number 
Output: AL= Number of installed drives or volumes 
Remarks: Drive A: has code number of 0, drive B: code number 1, etc. 


Even if the PC has only one disk drive and one hard disk, the number of 
volumes in the AL register can be greater than two because the hard disk 
can be divided into multiple volumes. In addition, the PC can have one or 
more RAM disks as part of its configuration. For a PC with a single disk 
drive, you can only have two volumes because drive A: also simulates 
drive B:. 


Unlike DOS Version 2, which permits 63 different device codes, DOS 
Version 3 permits 26 different devices (the letters A to Z). To keep 
compatibility between versions, limit your device access to a maximum 
of 26 devices. 


BIOS interrupt 11H does a better job of reading the number of disk drives 
than this function. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function O0FH | DOS 


Open file (FCB) (Version 1 and up) 
Opens a file if one is available. After this function call executes successfully, the 
file can be read or written. 

Input: AH= OFH 


DS = FCB segment address of the file 
DX = FCB offset address of the file 


Output: AL= 0: File found and opened 
AL= 255: File not found 


Remarks: Both normal and extended FCBs can be used. 


If the file was found, DOS enters, into the FCB, the file size, the date and 
the time of its creation or last modification. 


DOS sets the record length at 128 bytes. This record length can be 
changed in the FCB before opening a file. If you need a longer record 
length, the DTA must be moved (the original DTA is only 128 bytes 
long). 


If random file access is performed, the random record field in the FCB 
must be set after the file opens successfully. 


The file pointer points to the first byte of the file after the file opens. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 10H DOS 
Close file (FCB) (Version 1 and up) 


Writes all data currently in the DOS buffer to the file and closes the file. In 
addition, the directory entry changes to reflect the new file size and the date and 
time of the most recent modification to the file. | 


Input: AH= 10H 
DS = FCB segment address of the file 
DX = FCB offset address of the file 


Output: AL= 0: File closed and directory entry revised 
_ AL= 255: File not found in directory 


Remarks: Only open files can be closed. 


For disk files, the disk which was in the drive when the function call 
occurred must also be the disk that contains the file. Otherwise, the 
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function call writes an incorrect FAT and an incorrect directory to the 
disk, which makes the data that is already on the disk useless. 

The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 

Interrupt 21H, function 11H DOS 

Search for first match (FCB) (Version 1 and up) 

Searches for the first occurrence in the disk directory of the filename indicated in 
the FCB. 

Input: AH= 11H 
DS = FCB segment address 
DX = FCB offset address 

Output: AL= 0: File found 
AL= 255: File not found 

Remarks: The FCB passed to the function contains the drive specifier and the 


filename for which the function should search. 
The filename can contain the wildcard "?" to search for a group of files. 
The search is made only in the current directory of the indicated device. 


If the function searches for a normal file, a normal FCB can pass the 
information to the function. However, if you wish to search for a file 
with special attributes (volume name, subdirectories, hidden files, etc.), 
extended FCBs must be used. 


If a file was found, the DTA contains an FCB of the same type as the 
FCBs. This FCB in the DTA contains the found filename. For this 
reason, the DTA must always be large enough to accept either a normal 
or an extended FCB. 


The DTA can be switched to its own buffer using function 1AH, to 
ensure that it is large enough to accept the FCB. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 12H DOS 
Search for next match (FCB) (Version 1 and up) 


Searches for additional occurrences in the disk directory of the filename indicated in 
the FCB, after the file was found by function 17 (see above). 


Input: AH= 12H 
DS = FCB segment address 
DX = FCB offset address 


Output: AL= 0: File found 
AL= 255: File not found (no other files available) 


Remarks: This function can only be called after calling function 11H. 


The FCB passed to the function contains the drive specifier and the 
filename for which the function should search. 


If another filename was found its name is recorded in the FCB at the 
beginning of the DTA. 


The DTA can be switched with function 1AH to its own buffer to ensure 
that it is large enough to accept the FCB. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 13H DOS 
Delete file (FCB) (Version 1 and up) 


Erases one or more files in the current directory of the specified device. 
Input: AH= 13H 
DS = FCB segment address 
DX = FCB offset address 


Output: AL= 0: file(s) erased 
AL= 255: No file(s) found, or file(s) assigned Read Only attribute (undeletable) 


Remarks: The FCB passed to the function contains both the device on which the 
files to be erased are located and the name of the file. 


The filename can contain the wildcard "?" to erase a group of files. 
Only files in the current directory of the indicated device may be erased. 


If the function is used to delete a normal file, a normal FCB can pass the 
information to the function. However, if you want to delete a file with 
special attributes (volume name, subdirectories, hidden files, etc.), 
extended FCBs must be used. 
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Volumes may be deleted with this function; subdirectories may not. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 14H DOS 
Sequential read (FCB) (Version 1 and up) 


Reads the next sequential data block from a file. 


Input: 


Output: 


Remarks: 


AH= 14H 
DS = FCB segment address 
DX = FCB offset address 


AL= 0: Block read 

AL= 1: End of file reached 
AL= 2: Segment wrap 
AL = 3: Partial record read 


The function can only be called after the file was opened by the indicated 
FCB. 


The DTA reads the block. If the DTA is not large enough, function 1AH 
must move the DTA into its own buffer. 


The FCB records the size of the block and the corresponding number of 
bytes read. 


Error 2 occurs when the DTA reaches the end of a segment and the block 
being read extends beyond the end of the segment. 


Error 3 occurs when a partial block appears at the end of the file. The 
block is read in anyway and blank spaces bring the block up to the 
allocated block size. 


After reading a block, the file pointer resets to the beginning of the next 
block so that the next function call automatically reads the next block. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 15H DOS 
Sequential write (FCB) (Version 1 and up) 


Writes a sequential block to a file. 


Input: AH= 15H 
DS = FCB segment address 
DX = FCB offset address 


Output: AL= 0: Block written 
AL= 1: Medium (disk/hard disk) full 
AL= 2: Segment overflow 


Remarks: The function can only be called after the file was opened by the indicated 
FCB. 


The DTA writes the block it contains to the file. If the DTA is not large 
enough to hold the file, function 1AH must be used to move the DTA 
into its own buffer. 


The FCB records the size of the block and the corresponding number of 
bytes written. | 


Error 2 occurs if the DTA reaches the end of a segment and the block 
being written extends beyond the end of the segment. 


After writing a block, the file pointer resets to the beginning of the next 
block, so that the next function call automatically writes the next block. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 16H DOS 
Create or truncate file (FCB) (Version 1 and up) 


Creates a new file, or dumps the contents of an existing file (file size=O bytes). 
This function call allows other functions to read or write to the open file. 


Input: AH= 16H 
DS = FCB segment address 
DX = FCB offset address 


Output: AL= 0: File created or cleared 
AL= 255: File could not be created (e.g., directory full) 


Remarks: The contents of an existing file called by this function are lost. 
After calling this function, the file is already open; you don't need to open 
the file using function OFH (see above). 
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If you open the file using an extended FCB, you can assign certain 
attributes to the file (e.g., volume name, hidden file, etc.). 


You cannot create a subdirectory using this function. 
After opening the file, the file pointer moves to the first byte of the file. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 17H DOS 
Rename file (FCB) (Version 1 and up) 


Renames one or more files in the current directory of the specified device. 


Input: 


Output: 


Remarks: 


AH= 17H 
DS = FCB segment address 
DX = FCB offset address 


AL= 0: File(s) renamed 


AL= 255: No file found, or new filename matches old filename 


The FCB here is a special FCB, based on a normal FCB. The first 12 
bytes contain the drive specifier and the name of the file to be renamed. 
However, this type of FCB has the new drive specifier and the new 
filename stored starting at memory location 10H. The drive specifier must 
be identical for both filenames. 


The name of the file to be renamed can contain the wildcard "?", which 
renames several files. If the new filename contains the wildcard "?", the 
places in the filename and extension where a question mark appears in 
this parameter remain unchanged. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


787 


Appendix C: DOS Interrupts and Functions PC System Programming 


Interrupt 21H, function 19H DOS 
Get default disk drive (Version 1 and up) 


Returns the drive specifier of the default (current) disk drive. 


Input: AH= 19H 
Output: AL= Drive specifier 
Remarks: This function identifies drive A as code 0, drive B as code 1, etc. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 1AH DOS 
Set DTA address (Version 1 and up) 


Transfers the DTA (Disk Transfer Area) to another area of memory. The DTA acts 
as buffer memory for all FCB supported file accesses. 


Input: AH= 1AH 
DS = New DTA segment address 
DX = New DTA offset address 


Output: No output 
Remarks: This function must be called if the existing DTA has insufficient memory 
to handle the transmitted data. 


When the program starts, MS-DOS places the DTA at address 128 in the 
PSP. Since the program starts after address 255 of the PSP, it is 128 
bytes long. | 


DOS does not test the length of the DTA. Instead it assumes that the 
DTA is large enough to accept the transmitted data. If this is not the case, 
a DOS function can overwrite the excess data. 


DOS recognizes an error during various functions if the DTA is at the end 
of a segment and the data to be transmitted exceeds the end of the 
segment. 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 1BH DOS 
Get allocation information for default drive (Version 1 and up) 


Returns information about the format of the default drive. 
Input: AH= 1BH 


Output: AL= Number of sectors per cluster 
DS = Media descriptor segment address 
BX= Media descriptor offset address 
DX = Number of clusters 


Remarks: The media descriptor can return the following codes: 


F8H: Hard disk 

FOH: Disk drive: double-sided, 15 sectors per track (AT only) 
FCH: Disk drive: single-sided, 9 sectors per track 

FDH: _ Disk drive: double-sided, 9 sectors per track 

FEH: Disk drive: single-sided, 8 sectors per track 

FFH: Disk drive: double-sided, 8 sectors per track 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 1CH DOS 
Get allocation information for specified drive (Version 1 and up) 


Returns information about the format of the specified drive. 


Input: AH= 1CH 
DL= Drive specifier 


Output: AL= Number of sectors per cluster 
DS = Media descriptor segment address 
BX= Media descriptor offset address 
DX = Number of clusters 


Remarks: This function identifies drive A as code 0, drive B as code 1, etc. 


The media descriptor can return the following codes: 


F8H: Hard disk 

F9H: Disk drive: double-sided, 15 sectors per track (AT only) 
FCH: _ Disk drive: single-sided, 9 sectors per track 

FDH: Disk drive: double-sided, 9 sectors per track 

FEH: Disk drive: single-sided, 8 sectors per track 

FFH: Disk drive: double-sided, 8 sectors per track 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21(h), function 1DH DOS 
Reserved (Version 1 and up) 
Interrupt 21(h), function 1EH DOS 
Reserved (Version 1 and up) 
Interrupt 21(h), function 1FH DOS 
Reserved (Version 1 and up) 
Interrupt 21(h), function 20H DOS 
Reserved (Version 1 and up) 
Interrupt 21H, function 21H DOS 
Random read (FCB) (Version 1 and up) 


Reads a specified file record into the DTA. 


Input: 


Output: 


Remarks: 
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AH= 21H 
DS = FCB segment address 
DX = FCB offset address 


AL= 0: Record read 

AL= 1: End of file reached 
AL= 2: Segment overflow 
AL = 3: Partial record read 


The function can only be called after the file was opened by the indicated 
FCB. 


The record whose address is stored in the FCB starting at location 21H is 
read. 


The DTA reads the record. If the DTA is not large enough, function 1AH 
must be called to move the DTA into its own buffer. 


The FCB records the size of the record and the corresponding number of 
bytes read. 


During the function call, the file pointer moves to the beginning of the 
record being read so that a subsequent call of a sequential read (function 
14H—see above) reads the same record sequentially. 


The record number does not increment following the function call, so a 
new Call of this function would read the same record. 


Error 2 occurs when the DTA reaches the end of a segment and the record 
being read extends beyond the end of the segment. 
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Error 3 occurs when a partial record appears at the end of the file. The 
record is read in anyway and blank spaces bring the record up to the 
allocated record size. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 22H * DOS 
Random write (FCB) (Version 1 and up) 


Writes data from memory to the specified record in a file. 


Input: 


Output: 


Remarks: 


AH= 22H 
DS = FCB segment address 
DX = FCB offset address 


AL= 0: record was written 
AL= 1: Medium (disk/hard disk) full 
AL= 2: segment overflow 


The function can only be called after the file was opened by the indicated ° 
FCB. 


The record whose address is stored in the FCB starting at location 21H 1s 
read. 


The record is written from the DTA to the file. If the DTA is not large 
enough, function 1AH must move the DTA into its own buffer. 


The FCB records the size of the record and the number of bytes read. 


During the function call, the file pointer moves to the beginning of the 
record being read. This instructs subsequent calls of a sequential read 
(function 14H—see above) to read the same record sequentially. 


The record number does not increment following the function call, so a 
new Call of this function would read the same record. 


Error 2 occurs when the DTA reaches the end of a segment and the record 
being written extends beyond the end of the segment. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 23H DOS 
Get file size in records (FCB) (Version 1 and up) 


Determines the size of a file based on the number of records in that file. 
Input: AH= 23H 
DS = FCB segment address 
DX = FCB offset address 


Output: AL= 0: Number of records found starting at FCB address 21H 
AL = 255: File not found 


Remarks: The FCB passed contains the drive specifier as well as the name and 
| extension of the file to be examined. 


Unlike the other FCB supported file accesses, the FCB requires the record 
size before the application can call this function. 


A record size of 1 returns the size of the file in bytes. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 24H | DOS 
Set random record number (Version 1 and up) 


Sets the record number in the FCB to the current position of the file pointer. 
Random access may begin at the point at which earlier sequential accesses left off. 


Input: AH= 24H 
DS = FCB segment address 
DX = FCB offset address 


Output: No output 
Remarks: The function can only be called after the file was opened by the indicated 
FCB. | 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 25H DOS 
Set interrupt vector (Version 1 and up) 


Sets any interrupt vector to another routine. 


Input: AH = 25H 
AL = Interrupt number 
DS = New interrupt routine segment address 
DX = New interrupt routine offset address 


Output: No output 

Remarks: Before calling this function, the old contents of the interrupt vector to be 
changed should be read and stored using function 35H. After the program 
terminates, the old contents of the interrupt vector should be restored. 


The contents of the processor registers and the flag registers are not 


affected by this function. 
Interrupt 21H, function 26H DOS 
Create PSP (Version 1 and up) 
Copies the PSP (program segment prefix) of the executing program to a specified 
address in memory. 
Input: AH= 26H 
DX = New PSP segment address 
Output: No output 
Remarks: The new PSP offset address is 0. 


DOS Version 1 uses this function to execute other programs by creating a 
PSP, loading the program after this PSP and executing it. 


For DOS Version 2 up, use the EXEC function 4BH to load and execute 
additional programs instead of this function. 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 27H DOS 
Random block read (FCB) (Version 1 and up) 


Reads one or more sequentially stored records into memory. 


Input: 


Output: 


Remarks: 
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AH = 27H 

CX = Number of records to be read 
DS = FCB segment address 

DX = FCB offset address 


AL = 0: Record read 

AL = 1: End of file reached 
AL= 2: Segment overflow 
AL= 3: Partial record read 
CX = Number of records read. 


The function can only be called after the file was opened by the indicated 
FCB. 


The starting record is the record whose address is stored in the FCB, 
starting at location 21H. 


The record data passes to the DTA. If the DTA is not large enough, 
function 1AH must move the DTA into its own buffer. 


The FCB records the size of the record and the corresponding number of 
bytes read. 


After the function call, the file pointer moves to the end of the last record 
that was read so that it points to the next record (following the last record 


read). 


Error 2 occurs when the DTA reaches the end of a segment and the record 
being read extends beyond the end of the segment. 


Error 3 occurs when a partial record appears at the end of the file. The 
record is read in anyway and blank spaces bring the record up to the 
allocated record size. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 28H DOS 
Random block write (FCB) (Version I and up) 


Writes one or more records in sequence to the specified file. 


Input: 


Output: 


Remarks: 


AH = 28H 

CX = Number of records to be written 
DS = FCB segment address 

DX = FCB offset address 


AL= 0: Record written 

AL= 1: Medium (disk/hard disk) full 
AL= 2: Segment overflow 

CX = Number of records written 


The function can only be called after the file was opened by the indicated 
FCB. 


The starting record is the record whose address is stored in the FCB 
starting at location 21H. 


The FCB records the size of the record and the corresponding number of 
bytes read. 


The data is written from the DTA to the file. If the DTA is not large 
enough, function 1AH must move the DTA into its own buffer. 


After the function call, the file pointer moves to the end of the last record 
written so that it points to the next record, which follows the last record 
written. The record number increments by the number of records written. 


Error 2 occurs when the DTA reaches the end of a segment and the record 
being written extends beyond the end of the segment. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 29H DOS 
Parse filename to FCB (Version 1 and up) 


Transfers an ASCII format filename into the proper fields of an FCB. The filename 
can include a drive specifier, filename and file extension. 


Input: 


AH= 29H 

DS = Segment address of filename in memory 
SI= Offset address of filename in memory 
ES = FCB segment address 

DI= FCB offset address 
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AL= Transmission parameters: 


Bitl= 1: The drive specifier in the FCB changes only if the filename 
passed contains a drive specifier 
0: The drive specifier changes anyway. If the filename passed 
contains no drive specifier, the the FCB defaults to 0 
(current drive) 
Bit2= 1: The filename in the FCB changes only if the filename 
parameter passed contains a filename 
Q: The filename changes. If the filename passed does not con- 
tain a filename, the filename in the FCB fills with spaces 
(ASCII code 32) 
Bit3= 1: The file extension in FCB changes only if the filename 
passed contains an extension 
0: The file extension in the FCB changes. If the filename 
passed has no extension, the extension field is padded with 
spaces (ASCII code 32) 
Bits 4-8: Should contain the value 0 
Output: AL= 0: The filename passed contains no wildcards 
AL = 1: The filename passed contains wildcards 
AL= 255: Invalid drive specifier 
DS = Segment address of the first character after parsed filename 
SI= Offset address of the first character after parsed filename 
ES = FCB segment address 
DI= FCB offset address 
Remarks: The filename must end with an end character (ASCII code 0). 
If the filename contains the wildcard "*", all corresponding fields in the 
FCB fill with the wildcard "?". 
The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
Interrupt 21H, function 2AH © | DOS 
Get system date (Version 1 and up) 
Reads the current system date. 
Input: AH= 2AH 
Output: AL= Day of the week (0=Sunday, 1=Monday, etc.) 
CX= Year 
DH= Month 
DL= Day 
Remarks: DOS calls the clock driver to read the date. 
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The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 2BH DOS 
Set system date (Version 1 and up) 


Sets the current system date as returned by function 2AH (see above). 


Input: AH = 2BH 
CX = Year 
DH = Month 
DL= Day 
Output: AL= 0: O.K. 
AL= 255: Date incorrect 
Remarks: The date passes to the clock driver. 
If the PC does not have a realtime clock, the date remains in effect until 
the PC is switched off or rebooted. 
If the date entry is incorrect, the PC retains the old date. 
The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
Interrupt 21H, function 2CH DOS 
Get system time (Version 1 and up) 
Gets the current system time. 
Input: AH= 2CH 
Output: CH = Hours 
CL= Minutes 
DH = Seconds 
DL= Hundredths of a second 
Remarks: DOS calls the clock driver to read the time. 
The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
Interrupt 21H, function 2DH DOS 
Set system time (Version 1 and up) 
Sets the current system time. 
Input: AH = 2DH 
CH = Hours 
CL= Minutes 
DH = Seconds 


DL= hundredths of a second 
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Output: AL= 0: O.K. 
AL = 255: Incorrect time 


Remarks: The time passes to the clock driver. 


If the PC does not have a realtime clock, the time remains in effect until 
the PC is switched off or rebooted. 


If the time entry is incorrect, the PC retains the old time. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 2EH DOS 
Set verify flag (Version 1 and up) 


Sets the verify flag. This flag determines whether data should be verified after a 
write operation to a block driver for proper transmission. 


Input: AH= 2EH 
DL= 0 
AL= 0: Don't verify data 
AL= 1: Verify data 


Output: No output 

Remarks: This flag can be controlled at the user level with the VERIFY ON and 
VERIFY OFF commands. | 
The contents of the processor registers and the flag registers are not 
affected by this function. 

Interrupt 21H, function 2FH DOS 

Get DTA address (Version 2 and up) 


Returns the address of the DTA (Data Transmission Area), which serves as a data 
buffer for all FCB supported file accesses. 


Input: AH = 2FH 


Output: ES = DTA segment address 
BX= DTA offset address 


Remarks: This function determines the address of the DTA, but not the DTA’'s size. 


After the start of a program, the DTA starts at memory location 128 of 
the PSP and has a length of 128 bytes. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


798 


Abacus 2 Appendix C: DOS Interrupts and Functions 


Interrupt 21H, function 30H DOS 
Get MS-DOS version number (Version 2 and up) 


Returns the DOS version number. 
Input: AH = 30H 


Output: AL= Major version number (e.g., version 2.01=2) 
AH= Minor version number (e.g., version 3.01=01) 


Remarks: The major (whole) version number represents the number preceding the 
decimal point. For example, the version number 3.3 returns the major 
version number 3. 


The minor (fractional) version number represents the number following 
the decimal point. It is always given as two digits. For example, Version 
2.1 returns the minor version number 10 (OAH). 


If the AL register contains a value of 0, the program runs under DOS 
Version 1. DOS Version 1.0 cannot use this function. 


The contents of the DX, SI, DI, BP, CS, DS, SS, ES and the flag 
registers are not affected by this function. 


Interrupt 21H, function 31H DOS 
Terminate and stay resident (Version 2 and up) 


Terminates the currently executing program and returns control to the calling 
program. The current program remains in memory for later recall. 


Input: AH= 31H 
AL= Return code 
DX = Number of paragraphs to be reserved 
Output: No output 
Remarks: The return code in the AL register indicates whether or not the program 


called by it correctly executes. The calling program can read this number 
by calling function 77 (4DH). This value can be tested from within a 
batch file using the ERRORLEVEL and IF commands. 


The number of 16-byte paragraphs to be reserved indicates how many 
bytes, beginning with the PSP, cannot be released for other uses. 


Memory blocks reserved by function 48H are not affected by the value in 
the DX register because they can only be released by calling function 
49H. 
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Interrupt 21H, function 33H, sub-function 0 DOS 
Get <Ctrl><Break> flag (Version 2 and up) 


Reads the <Ctrl><Break> flag. This determines whether DOS should test for 
active <Ctrl><C> or <Ctrl><Break> keys on each function call, or on character 
input/output calls. <Curl><C> and <Ctrl><Break> trigger interrupt 23H. 


Input: AH = 33H 
AL= 0 
Output: DL= 0: Test only during character input/output 


DL= 1: Test on every function call 


Remarks: Since the <Ctrl><Break> flag is not part of the environment block of a 
program, it affects all programs which call the DOS character functions 
that test for <Ctrl><C> or the <Break> key. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 33H, sub-function 1 DOS 
Set <Ctrl><Break> flag (Version 2 and up) 


Sets and unsets the <Ctrl><Break> flag. This determines whether DOS should test 
for the activation of the <Ctrl><C> or <Ctrl><Break> keys on each DOS 
function call or character input/output calls. <Ctrl><C> and <Ctrl><Break> 


trigger interrupt 23H. 
Input: AH= 33H 
AL= 1 


DL= 0: Test only during character input/output 
DL= 1: Test on every function call 


Output: No output 

Remarks: Since the <Ctrl><Break> flag is not part of the environment block of a 
program, it affects all programs which call the DOS character functions 
that test for <Ctrl><C> or the <Break> key. 


The contents of the processor registers and the flag registers are not 
affected by this function. 
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Interrupt 21H, function 35H DOS 
Get interrupt vector (Version 2 and up) 


Returns the current contents of an interrupt vector and the address of the interrupt 
routine that belongs to it. 


Input: AH = 35H 
AL = Interrupt number 


Output: ES = Interrupt routine segment address 
BX= Interrupt routine offset address 


Remarks: To ensure compatibility with future versions of DOS, instead of reading 
the vector's contents directly from the interrupt vector table, call this 
function for reading an interrupt vector. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 


Interrupt 21H, function 36H DOS 
Get free disk space (Version 2 and up) 


Returns information about the device (the block driver) from which the 
available memory space can be calculated. 


Input: AH = 36H 
DL= Device code 


Output: AX = 65535: Device unavailable 
AX<_ 65535: Number of sectors per cluster 
BX= Number of available clusters 
CX = Number of bytes per sector 
DX = Total number of clusters on the device 


Remarks: This function identifies drive A as code 0, drive B as code 1, etc. 


The remaining memory on the medium can be computed from the number 
of bytes per sector multiplied by the number of sectors per cluster, 
multiplied by the number of free clusters. 


The contents of the SI, DI, BP, CS, DS, SS, ES and the flag registers are 
not affected by this function. 
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Interrupt 21H, function 38H DOS 
Get country | (Version 2 and up) 


Determines country-specific parameters, which are set in the CONFIG.SYS file 


using the DOS COUNTRY command. 
Input: AH= 38H 
AL= 0 


DS = Buffer segment address 
DX= Buffer offset address 


Output: No output 


Remarks: Before the function call, function 30H should be used to determine the 
DOS version. This can help the programmer compensate for differences 
between DOS versions during the call and return of this function. 


The buffer must have at least 32 bytes allocated for recording the various 
country-specific parameters. 


Following the function call, the individual bytes of this buffer contain the 
following information: _ 


Bytes 0-1: Date format 
0 = USA: Month-day-year 
1 = Europe: day-month-year 
2 = Japan: Year-month-day 
Byte 2: ASCII code of the currency symbol 
Byte 3: 0 
Byte 4: ASCII code of the thousand character (comma/period) 
Byte 5: 0 
Byte 6: ASCII code of decimal character (period/comma) 
Byte 7: 0 
Bytes 8-31: reserved 


The contents of the processor registers and the flag registers are not 
affected by this function. 


Interrupt 21H, function 38H, sub-function 0 DOS 
Get country (Version 3 and up) 


Gets the country-specific parameters that are currently set. 


Input: AH= 38H 
DS = Buffer segment address 
DX = Buffer offset address 
AL= 0: read current country parameters 
AL= 1-254: Country code parameters to be read 
AL = 255: Country code parameters to be read placed in the BX register 
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Carry flag=0: O.K. 
Carry flag=1: Invalid country code 


Before the function call, function 30H should be used to determine the 
DOS version. This can help the programmer compensate for differences 
between DOS versions during the call and return of this function. 


The buffer must have at least 32 bytes allocated for recording the various 
country specific parameters. 


Following the function call, the individual bytes of this buffer contain the 
following information: 


Bytes 0-1: Date format 
0 = USA: Month-day-year 
1 = Europe: Day-month-year 
2 = Japan: Year-month-day 
Bytes 2-6: Currency indicator (string terminated by an end character) 
Byte 7: ASCII code of the thousand character (comma/period) 
Byte 8: 0 
Byte 9: ASCII code of decimal character (period/comma) 
Byte 10: 0 
Byte 11: ASCII code of the date separation character 
Byte 12: 0 
Byte 13: ASCII code of the time separation character 
Byte 14: 0 
Byte 15: Currency format 
bit 0 = 0: Currency symbol before the dain 
bit 0 = 1: Currency symbol after the value 
bit 1 = 0: No spaces between value and currency symbol 
bit 1 = 1: Space between value and currency symbol 
Byte 16: Precision (number of decimal places) 
Byte 17: Time format 
bit 0 = 0: 12-hour clock 
bit 0 = 1: 24-hour clock 
Bytes 18-21: Address of character conversion routine (see below) 
Bytes 22-33: reserved 


Addresses 18 to 21 are the offset and segment addresses of a FAR 
procedure, which is used for accessing the country specific characters from 
the character set of the PC. The routine views the AL register's contents 
as the ASCII code of a lower case letter that should be converted to a 
capital letter. If a capital letter exists, it is retained in the AL register after 
the call. If the letter doesn't exist, the contents of the AL register remain 
unchanged. For example, the routine could be used to convert a lower case 
"a" into a capital "A". 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
the flag registers are not affected by this function. 
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Interrupt 21H, function 38H, sub-function 1 DOS 
Set country (Version 3 and up) 


Sets the current country-specific parameters. These parameters can be read using 
function 38H, sub-function 0. Previous versions of DOS required country-specific 
settings fromthe CONFIG.SYS file using the COUNTRY command. This 
function allows the user to set and change these parameters after booting. 


Input: AH= 38H 
DX= 65535 
AL= 1-254: Number of the country 
AL > 254: Look in BX for country number 
BX = Number of the country Gf AL > 254) 


Output: Carry flag=0: O.K. 
Carry flag=1: Invalid country code 


Remarks: Before the function call, function 30H should be used to determine that 
this command exists. 


This function only allows setting of the country code, for which DOS has 
preset parameters. These parameters cannot be changed from this function. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 39H DOS 
Create subdirectory (Version 2 and up) 


Creates a new subdirectory on the specified device. 


Input: AH= 39H 
DS = Subdirectory path segment address 
DX = Subdirectory path offset address 


Output: Carry flag=0: Subdirectory created 
Carry flag=1: Error (AX = error code) 
AX=3: Path not found 
AX=5: Access denied 


Remarks: The subdirectory path passed is an ASCII string which is terminated by 
an end character (ASCII code 0). 


If the subdirectory path contains a drive specifier, the indicated device is 
accessed. Otherwise DOS creates the subdirectory on the current device. 


An error can occur if any element of the path designation doesn't exist, a 
subdirectory already exists by that name, or the directory to be made is a 
subdirectory of the root directory and it is already filled. 
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The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 3AH DOS 
Delete subdirectory (Version 2 and up) 


Deletes a subdirectory from the specified drive. 


Input: AH= 3AH 
DS = Subdirectory path segment address 
DX = Subdirectory path offset address 
Output: Carry flag=0: Subdirectory deleted 
Carry flag=1: Error (AX = error code) 
AX=3: Path not found 
AX=5: Access denied 
AX=6: Directory to be deleted is the current directory 
Remarks: The subdirectory path passed is an ASCII string which is terminated by 
an end character (ASCII code 0). 
If the subdirectory path contains a drive specifier, the indicated device is 
accessed. Otherwise DOS deletes the subdirectory from the current device. 
An error can occur if any element of the path designation doesn't exist, 
the subdirectory is the current directory, or the directory to be deleted still 
contains files. 
The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
Interrupt 21H, function 3BH DOS 
Set current directory (Version 2 and up) 


Sets the current subdirectory for the device indicated. 


Input: 


Output: 


Remarks: 


AH= 3BH 
DS = Subdirectory path segment address 
DX = Subdirectory path offset address 


Carry flag=0: Subdirectory set 
Carry flag=1: Error (AX = error code) 
=3;: Path not found 


The subdirectory path passed is an ASCII string which is terminated by 
an end character (ASCII code 0). 


If the subdirectory path contains a drive specifier, the indicated device is 
accessed. Otherwise DOS deletes the subdirectory from the current device. 
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An error can occur if any element of the path designation doesn't exist. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 3CH DOS 
Create or truncate file (handle) (Version 2 and up) 


Creates a new file, or dumps the contents of an existing file (file size=0 bytes). 
This function call allows other functions to read or write to the open file. 


Input: AH = 3CH 
CX = File attribute 
Bit 0 = 1: File is read only 
Bit 1 = 1: Hidden file 
Bit 2 = 1: System file 
DS = Filename segment address 
DX = Filename offset address 


Output: Carry flag=0: O.K. (AX = file handle) 
Carry flag=1: Error (AX = error code) 
AX=3;: Path not found 
AX=4: No available handle 
AX=5: Access denied 


Remarks: The various bits of the file attribute can be combined with each other. 


The filename must be available as an ASCII string terminated by an end 
character (ASCII code 0). The filename parameter can contain a driver 
specifier, path, filename and extension. No wildcards are allowed. If you 
omit the drive specifier or path, DOS accesses the current drive or current 
directory. 


An error can occur if any element of the path designation doesn't exist, if 
the file must be created in the root directory which is already full, or if a 
file with the same name already exists but cannot be cleared because it is 
write protected (bit 0 in the file attribute byte = 1). 


If the function call executed successfully, all other handle functions can be 
called with this handle once the file opens. 


The file pointer is set to the first byte of the file. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 3DH DOS 
Open file (handle) (Version 2 and up) 


Opens an existing file for access by other functions. 


Input: 


Output: 


Remarks: 


AH= 3DH 

AL= Access mode : 

Bits 0-2: Read/write access 
000(b) = File is read only 
001(b) = File can oniy be written 
010(b) = File can be read and written 

Bit 3: 0(b) 

Bits 4-6: File sharing mode 
000(b) = Only current program can access the file (FCB mode) 
001(b) = Only the current program can access the file 
010(b) = Another program can read but not write the file 
011(b) = Another program can write but not read the file 
100(b) = Another program can read and write the file 

Bit 7: Handle flag 
0 = Child program of the current program can access file handle 
1 = Current program can access file handle only 

DS = Filename segment address 

DX = Filename offset address 


Carry flag=0: O.K. (AX = file handle) 
Carry flag=1: Error (AX = error code) 
AX=1:Missing file sharing software 
=2: File not found 
AX=3: Path not found or file doesn't exist 
AX=4: No handle available 
AX=5: Access denied 
AX=12: Access mode not permitted 


The filename must be available as an ASCII string terminated by an end 
character (ASCII code 0). The filename parameter can contain a driver 
specifier, path, filename and extension. No wildcards are allowed. If you 
omit the drive specifier or path, DOS accesses the current drive or current 
directory. 


If the function call executes successfully, all other handle functions can be 
called with this handle once the file opens. 


The file pointer is set to the first byte of the file. 


DOS Version 2 uses only bits 0 to 2 of the access mode. All other bits, 
even under Version 3, should be 0 to ensure proper execution of the call. 


DOS Version 3 uses the file sharing mode in bits 4 to 6 of the access 
mode only if the file is on a mass storage device which is part of a 
network. These three bits decide if and how the file, while it is open 
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using the current call, may be accessed by other programs from other PCs 
on the network. | 


Error 12 can occur only under DOS Version 3 and only within a network 
when the file is already opened by another program and if no other 
program can gain access to that file. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 3EH DOS 
Close file (handle) (Version 2 and up) 


Writes any data in the DOS buffers to a currently open file, then closes the file. If 
changes occur to the file, the new file size and the last date and time of 


modification are added to the directory. 
Input: AH= 3EH 
BX= Handle to be closed 
Output: Carry flag=0: O.K. 


Carry flag=1: Error (AX = error code) 
AX=6: Unauthorized handle or file not opened 


Remarks: Do not accidentally call this function with the numbers of the previous 
handle (the numbers 0 to 4) because the standard input device or standard 
output device may close. This would leave you unable to enter characters 
from the keyboard or display characters on the screen. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 3FH DOS 
Read file or device (handle) (Version 2 and up) 


Reads a certain number of characters by using a handle from a previously opened 
file or device and passes the characters to a buffer. The read operation starts at the 
current file pointer position. 


Input: AH = 3FH 
BX= File or device handle 
CX = Number of bytes to be read 
DS = Buffer segment address 
DX = Buffer offset address 


Output: Carry flag=0: O.K. (AX = number of bytes read) 
Carry flag=1: Error (AX = error code) 
AX=5: Access denied 
AX=6;: Illegal handle or file not open 


808 


Abacus 


Appendix C: DOS Interrupts and Functions 


Remarks: 


Characters can be read from a file or from a device (e.g., the standard input 
device [keyboard], which has the handle 0). 


When the carry flag resets after the function call but the AX register has 
the value 0, this means that the file pointer has already reached the end of 
the file before the function call. So, no files could be read. 


When the carry flag resets after the function call but the contents of the 
AX register are smaller than the contents of the CX register before the 
function call, this means that the desired number of bytes wasn't read 
because the end of the file was reached. 


After the function call, the file pointer follows the last byte read. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 40H DOS 
Write to file or device (handle) (Version 2 and up) 


Writes a certain number of characters from a buffer to an open file or device by 
using a handle. The write operation begins at the file pointer's current position. 


Input: 


Output: 


Remarks: 


AH= 40H 

BX= File or device handle 

CX = Number of bytes to be written 
DS = Buffer segment address 

DX = Buffer offset address 


Carry flag=0: O.K. (AX = number of bytes written) 
Carry flag=1: Error (AX = error code) 
AX=5: Access denied 
=6: Illegal handle or file not-open 


Characters can be written to a file or to a device (e.g., the standard output 
device [screen], which has the handle 1). 


When the carry flag resets after the function call but the AX register has 
the value 0, this means that the file pointer has already reached the end of 
the file before the function call. Therefore no files could be written. 


When the carry flag resets after the function call but the contents of the 
AX register are smaller than the contents of the CX register before the 
function call, this means that the desired number of bytes were not 
written because the end of file was reached. | 


After the function call, the file pointer follows the last byte written. 
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The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 41H DOS 
Delete file (handle) (Version 2 and up) 


Deletes the filename passed to the function. Through the call of this function, a 
file is erased and its name is passed to the function. 


Input: 


Output: 


Remarks: 


AH= 41H 
DS = Filename segment address 
DX = Filename offset address 


Carry flag=0: O.K. 
Carry flag=1: Error (AX = error code) 
=2: File not found 
AX=5: Access denied 


The filename must be available as an ASCII string terminated by an end 
character (ASCII code 0). The filename parameter can contain a drive 
specifier, path, filename and extension. No wildcards are allowed. If you . 
omit the drive specifier or path, DOS accesses the current drive or current 
directory. 


An error occurs when any element of the path designation doesn't exist or 
when the file has the attribute Read Only and therefore can not be written 
to or deleted. This attribute can be changed by using function 43H. 


You cannot delete subdirectories or volume names with this function. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 42H DOS 
Move file pointer (handle) (Version 2 and up) 


Moves the file pointer of a previously opened file by using its handle. This allows 
random access because the individual records don't have to be read in sequence. The 
new file pointer position is given as an offset from the current position, either 
from the beginning of the file or from the end of the file. The offset itself is 
indicated as a 32-bit number. 


Input: 
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AH= 42H 

AL= Offset code 
AL=0: Offset is relative to the beginning of the file 
AL=1: Offset is relative to the current position of the file pointer 
AL=2: Offset is relative to the end of the file 

BX= Handle 

CX = High word of the offset 
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Output: 


Remarks: 


DX = Low word of the offset 


Carry flag=0: O.K. 
DX = High word of the file pointer 
AX = Low word of the file pointer 
Carry flag=1: Error (AX = error code) 
AX=1: Illegal offset code 
AX=6: Illegal handle or File not open 


If offset codes 1 and 2 are accessed, negative offsets may be used to move 
the file pointer backwards or to place the pointer at the beginning of the 
file. It's possible to set the file pointer before the end of the file, which 
Causes an error during the next read or write access to the file. 


The position of the file pointer passed after the function call is always 
relative to the beginning of the file. The offset code used during the 
function call is independent of this file pointer position. 


Passing offset code 2 and offset 0 returns the size of the file. This action 
moves the file pointer to the last byte of the file and the pointer's 
position returns to the calling program after the function call. 


The contents of the BX, CX, , SI, DI, BP, CS, DS, SS and ES registers 
are not affected by this function. 


Interrupt 21H, function 43H, sub-function 0 DOS 
Get file attributes (Version 2 and up) 


Determines file attributes. 


Input: 


Output: 


Remarks: 


AH= 43H 

AL= 0 

DS = Filename segment address 
DX = Filename offset address 


Carry flag = 0: O.K. (CX = file attribute) 
Bit O=1: File can be read but not written 
Bit 1=1: File hidden (not displayed on DIR) 
Bit 2=1: File is a system file 
Bit 3=1: File is the volume name 
Bit 4=1: File is a subdirectory 
Bit 5=1: File was changed since the last date/time 
Carry flag = 1: Error (AX = error code) 
AX=1: Unknown function code 
=2: File not found 
=3: Path not found 


The filename must be available as an ASCII string terminated by an end 


character (ASCII code 0). The filename parameter can contain a driver 
specifier, path, filename and extension. No wildcards are allowed. If you 
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omit the drive specifier or path, DOS accesses the current drive or current 
directory. 


An error occurs when any element of the path designation or the file does 
not exist. 


The contents of the BX, CX, , SI, DI, BP, CS, DS, SS and ES registers 
are not affected by this function. 


Interrupt 21H, function 43H, sub-function 1 DOS 
Set file attributes (Version 2 and up) 
Sets the file attributes. 
Input: AH= 43H 
AL= 1 


Output: 


Remarks: 


CX = File attributes 

Bit 0 = 1: File can be read but not written 

Bit 1 = 1: File hidden (not displayed on DIR) 

Bit 2 = 1: File is a system file 

Bit 3 =0 

Bit 4=0 

Bit 5 = 1: File was changed since the last date/time 
DS = Filename segment address 

DX = Filename offset address 


Carry flag=0: O.K. 

Carry flag=1: Error (AX = error code) 
AX=1: Unknown function code 
AX=2: File not found 
AX=3: Path not found 

=5: Attribute cannot be changed 


The filename must be available as an ASCII string terminated by an end 
character (ASCII code 0). The filename parameter can contain a driver 
specifier, path, filename and extension. No wildcards are allowed. If you 
omit the drive specifier or path, DOS accesses the current drive or current 
directory. 


An error occurs when any element of the path designation or the file does 
not exist. 


Neither subdirectories nor volume names can be accessed with this 
function. For this reason bits 3 and 4 of the file attribute must be 0. 
during the function call. If you attempt to access a subdirectory or a 
volume name anyway, the function returns error code 5. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 44H, sub-function 0 DOS 
IOCTL: Get device information (Version 2 and up) 


Permits access of a character driver's device attribute. 


Input: 


Output: 


Remarks: 


AH= 44H 
AL= 0 
BX= Handle 


Carry flag=0: O.K. (DX = device attribute) 
Bit 4= 1: Processes control characters through IOCTL 
Bit 7= 1: Character driver 
Bit5= 0: Cooked mode operation 
1: Raw mode operation 

Bit3= 1: Clock driver operation 
Bit2= 1: NUL driver operation 
Bit1= 1: Console output driver (screen) 
BitO= 1: Console input driver (keyboard) 
Carry flag=1: Error (AX = error code) 

AX=1: Unknown function code 

AX=6: Handle not opened cr does not exist 


A handle is passed (not the name of the addressed character driver which 
must be connected with this driver). This can be one of the five pre- 
assigned handles (0 to 4). A handle could have been previously opened for 
a certain device with the help of the Open function (function 3DH), and 
then passed to the function. For example, since the standard input and 
output devices (handles 0 and 1) can be redirected, this method assures that 
the indicated device is accessed. 


If bit 7 in the device attribute is unequal to 1, the driver addressed is not a 
character driver and the significance of the individual bits in the device 
attribute disagrees with those of the device driver. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 1 DOS 
IOCTL: Set device information (Version 2 and up) 


Sets the character device attributes. 


Input: 


AH = 44H 

AL= 1 

BX= Handle 

CX = Number of bytes written 

DX = Device attributes 

Bit 14= 1: Processes control characters through IOCTL using sub- 
functions 2 and 3 

Bit 7 = 1: Character driver 
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Bit 5 = 0: Cooked mode operation 

Bit 5 = 1: Raw mode operation 

Bit 3 = 1: Clock driver operation 

Bit 2 = 1: NUL driver operation 

Bit 1 = 1: Console output driver (screen) 
Bit 0 = 1: Console input driver (keyboard) 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Unknown function code 
AX=6: handle not opened or handle does not exist 


Remarks: A handle is passed but it is not the name of the addressed character device, 
which must be connected with this device. This can be one of the five 
pre-assigned handles (0 to 4). A handle could have previously been 
opened, with the Open function, for a certain device and then passed to the 
function. For example, since the standard input and output devices 
(handles 0 and 1) can be redirected, this method assures that the indicated 
device is accessed. 

To change various device attribute bits with this function, use sub- 


function 0 to read the device attributes first. Then this sub-function can 
reset the device attribute bits in the device driver. 


If bit 7 in the device attribute is unequal to 1, the driver addressed is not a 
character driver. The meanings of the individual bits in the device attribute 
disagree with those in the device driver. 


This function is especially useful for switching between cooked mode and 
raw mode within a character driver (bit 5). 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 2 DOS 
IOCTL: Read data from character device (Version 2 and up) 


Reads data from a character device. This function defines the number of bytes of 
data to read from the buffer, which contains the data taken from the character 


device. 
Input: AH= 44H 
AL= 2 
BX= Handle 


CX = Number of bytes to be read 
DS = Buffer segment address 
DX = Buffer offset address 
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Carry flag=0: O.K. (AX = Number of bytes sent) 
Carry flag=1: Error (AX = Error code) 

AX=1: Unknown function code 

AX=6: Handle not opened or does not exist 


A handle is passed, but it is not the name of the addressed character device 
which must be connected with this device. This can be one of the five 
pre-assigned handles (0 to 4). A handle could have previously been opened 
with the Open function (function number 3DH) for a certain device, then 
passed to the function. For example, since the standard input and output 
devices (handles 0 and 1) can be redirected, this method assures that the 
indicated device is accessed. 


An error always occurs if the handle passed is connected with a block 
driver instead of a character driver. 


The driver defines the data type and structure. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 3 DOS 
IOCTL: Send data to character device (Version 2 and up) 


Sends data from an application program directly to a character device. The calling 
function defines the number of bytes to be transferred from a buffer to the device. 


Input: 


Output: 


Remarks: 


AH = 44H 
AL= 3 
BX= Handle 


CX = Number of bytes to be transmitted 
DS = Buffer segment address 
DX = Buffer offset address 


Carry flag=0: O.K. 
AX = Number of bytes sent 
Carry flag=1: Error (AX = Error code) 
AX=1: Unknown function code 
AX=6: Handle not opened or does not exist 


A handle is passed, but it is not the name of the addressed character device 
which must be connected with this device. This can be one of the five 
pre-assigned handles (0 to 4). A handle could have previously been opened 
with the Open function (function number 61) for a certain device, then 
passed to the function. For example, since the standard input and output 
devices (handles 0 and 1) can be redirected, this method assures that the 
indicated device is accessed. 


An error always occurs if the handle passed is connected with a block 
driver instead of a character driver. 
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The driver defines the data type and structure. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 4 DOS 
IOCTL: Read data from block device (Version 2 and up) 


Reads data for an application directly from a block device. The calling function 
defines the number of bytes to be copied by the device into a buffer. 


Input: AH= 44H 
AL= 4 
BX= Device designation 
CX = Number of bytes to be read 
DS = Buffer segment address 
DX = Buffer offset address 


Output: Carry flag=0: O.K. 
AX = Number of bytes sent 
Carry flag=1: Error (AX = Error code) 
AX=1: Unknown function code 
AX=15: Unknown device 


Remarks: Instead of defining the device driver, the device designation parameter 
defines the device from which data will be received. Code 0 represents 
device A:, 1 represents device B:, etc. 


The driver defines the data type and structure. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 5 DOS 
IOCTL: Send data to block device (Version 2 and up) 


Sends data from an application program directly to a character device. The calling 
function defines the number of bytes to be transferred from a buffer to the device. 


Input: AH= 44H 
AL= 5 
BX= Device designation 
CX = Number of bytes to be sent 
DS = Buffer segment address 
DX = Buffer offset address 


Output: Carry flag=0: O.K. 
AX = Number of bytes sent 
Carry flag=1: Error (AX = Error code) 
AX=1: Unknown function code 
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AX=15: Unknown device 
Remarks: Instead of defining the device driver, the device designation parameter 
defines the device from which data will be received. Code 0 represents 
device A:, 1 represents device B:, etc. 
The driver defines the data type and structure. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 6 DOS 
IOCTL: Read input status (Version 2 and up) 


Determines whether a device driver can transmit data to an application program. 


Input: AH= 44H 
AL= 6 
BX= Handle 
Output: Carry flag=0: O.K. (AX = Input status) 
AX=0: Driver not ready 


AX=255: Driver ready 

Carry flag=1: Error (AX = Error code) 
AX=1: Unknown function code 
AX=5: Access denied 


Remarks: The handle passed can refer to either a character driver or a file. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 7 DOS 
IOCTL: Read output status (Version 2 and up) 


Determines whether a device driver can receive data from an application program. 


Input: AH= 44H 
AL= 7 
BX= Handle 
Output: Carry flag=0: O.K. (AX = Output status) 


AX=0: Driver is not ready 
AX=255: Driver is ready 

Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=5: Access denied 
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Remarks: The handle passed can refer to either a character driver or a file. 


If the handle refers to a file, the block device driver signals its read‘ness to 
receive data, even-if the medium containing the file is full and no 
additional data can be appended to the end of the file. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 8 DOS 
IOCTL: Test for changeable block device (Version 3 and up) 
Determines whether the block device medium (e.g., disk, hard disk, etc.) can be 
changed. 
Input: AH = 44H 
AL= 8 


BL= Device designation 


Output: Carry flag=0: O.K. (AX=status code) 
AX = 0: Medium changeable 
AX = 1: Medium unchangeable 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=15: Invalid drive number 


Remarks: The device designation parameter defines the device being addressed instead 
of the device driver. Code 0 represents device A:, 1 represents device B:,. 
etc. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 9 DOS 
IOCTL: Test for local or remote drive (Version 3.1 and up) 


Determines whether a drive (block device) is local (part of the PC making the 
inquiry) or remote (part of another PC in a network). 


Input: AH= 44H 

AL= 9 

BL= Device designation 
Output: Carry flag=0: O.K. 

DX = device attribute 

Bit 12 = 0: Local 


Bit 12 = 1: Remote 

Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=15: Invalid drive specification 
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Remarks: You can access this sub-function only if networking software has 
previously been installed. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 0AH DOS 
IOCTL: Test for local or remote handle (Version 3.1 and up) 


Determines whether a file associated with this handle is local (part of the PC 
making the inquiry) or remote (part of another PC in a network). 


Input: AH = 44H 
AL= OAH 
BX= Handle 
Output: DX = IOCTL code 
Bit 15 = 0: Local 


Bit 15 = 1: Remote 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=6: Handle not opened or does not exist 


Remarks: You can access this sub-function only if networking software has 
previously been installed. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 44H, sub-function 0BH DOS 
IOCTL: Change retry count (Version 3 and up) 


Sets the variables that specify the number of attempts at file access. One PC 
within a network may try to access a file that is already being accessed by another 
PC. The PC attempting access repeats the file access procedure the number of 
times and the number of waiting periods defined by these variables. 


Input: AH= 44H 
AL= OBH 
BX= Number of attempts 
CX = Waiting time between attempts 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 


Remarks: You can only access this sub-function if networking software has 
previously been installed. 
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The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 45H | DOS 
Duplicate handle (Version 2 and up) 


Creates a duplicate of the handle passed. This duplicate handle interfaces with the 
same file or device as the first handle. If the first handle refers to a file, the value of 
the first handler's file pointer joins with the file pointer of the duplicate handle. 


Input: AH= 45H 
BX= Handle 
Output: Carry flag=0: O.K. (AX = the new handle 


Carry flag=1: Error (AX = Error code) 
AX=4: No additional handle available 
AX=6: Handle not opened or does not exist 


Remarks: Without having to close the file, this function updates a file directory 
entry after its modification. A file can be closed using function 62 (3EH). 


If the file pointer of one of the two handles changes position due to the 
call of a read or write function, the other file pointer also changes 
automatically. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 46H DOS 
Force duplicate of handle (Version 2 and up) 


Refers a second file handle to the save device or file as the first file handle. The 
second handle's file pointer also contains the same value as the first handle's file 
pointer. | 


Input: AH= 46H 
BX= First handle 
CX = Second handle 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=4: No additional handle available 
AX=6: Handle not opened or does not exist 


Remarks: If the function call connects the second handle to an open file, the file 
closes before the forced duplication. 


If the file pointer of one of the handles changes position due to the call of 
a read or write function, the other file pointer also changes automatically. 
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The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 47H DOS 
Get current directory (Version 2 and up) 


Gets an ASCII string listing the complete path designation of the current directory 
of the indicated device. This string passes to the specified buffer. 


Input: AH = 47H 
DL= Device designation 
DS = Buffer segment address 
SI= Buffer offset address 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX=Enrror code) 
AX=15: Invalid drive specification 


Remarks: The device designation parameter defines the device being addressed instead 
of the device driver. Code 0 represents the current device, 1 represents 
device A:, etc. 


The path description in the buffer terminates with an end character (ASCII 
code 0). This description has no drive specifier or \ character (root 
directory specifier). If the root directory is the current directory, the end 
character becomes the first character in the buffer. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 48H DOS 
Allocate memory (Version 2 and up) 


Reserves an area of memory for program use. 


Input: AH= 48H 
BX= Number of paragraphs to be reserved 


Output: Carry flag=0: O.K. 
AX=Memory area segment address) 
Carry flag=1: Error (AX = Error code) 
AX=7: Memory control block destroyed 
=8: Insufficient memory 
BX= Number of paragraphs available 


Remarks: A paragraph consists of 16 bytes. 
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If memory allocation was successfully executed, the allocated range 
begins at address AX:0000. 


This function always fails when executed from within a COM program 
because the PC assigns the total amount of free memory to a COM 
program when it executes. 


The contents of the CX, DX, SI, DI, BP, CS, DS, SS and ES registers 
are not affected by this function. 


Interrupt 21H, function 49H DOS 
Release memory (Version 2 and up) 


Releases memory previously allocated by function 72 (49H—see above) for any 


purpose. 


Input: 


Output: 


Remarks: 


AH= 49H 
ES = Memory area segment address 


Carry flag=0: O.K. 

Carry flag=1: Error (AX = Error code) 
AX=7: Memory control block destroyed 
AX=9: Incorrect memory area passed in ES 


Since DOS knows the size of the memory area to be released, no 
parameter exists for passing memory size. 


If the wrong segment address appears in the ES register during the 
function call, memory assigned to another program can be released. This 
can lead to a system crash or other consequences. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 4AH DOS 
Modify memory allocation (Version 2 and up) 


Changes the size of a memory area previously reserved using function 72 (3FH— 
see above). 


Input: 


Output: 
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AH = 4AH 
BX= New memory area size in paragraphs 
ES = Memory area segment address 


Carry flag=0: O.K. 

Carry flag=1: Error (AX = Error code) 
AX=7: Memory control block destroyed 
AX=8: Insufficient memory 

BX= Number of paragraphs available 
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Remarks: 


A paragraph has 16 bytes. 


If the wrong segment address appears in the ES register during the 
function call, memory assigned to another program can be released. This 
can lead to a system crash or other consequences. 


Since the PC assigns the total amount of free memory to a COM 
program when it executes, this function call always fails when executed 
from within a COM program. 


COM programs should use this function to release all unnecessary 
memory since all RAM becomes part of a COM program. This is 
especially important before calling the EXEC function (function number 
75 (4BH). 


The contents of the CX, DX, SI, DI, BP, CS, DS, SS and ES registers 
are not affected by this function. 


Interrupt 21H, function 4BH, sub-function 0 DOS 
Execute program (Version 2 and up) 


Input: 


Output: 


Remarks: 


Executes another program from within a program and continues execution of the 
original program after the called program finishes its run. The function requires the 
name of the program to be executed and the address of a parameter block, which 
contains information that is important to the function. 


AH = 4BH 

AL= 0 

ES = Parameter block segment address 
BX= Parameter block offset address 
DS = Program name segment address 
DX = Program name offset address 


Carry flag=0: O.K. 

Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=2: Path or program not found 
AX=5: Access denied 
AX=8: Insufficient memory 
AX=10: Wrong environment block 
AX=11:; Incorrect format 


The directory name passed is an ASCII string which is terminated by an 
end character (ASCII code 0). It can contain a path designation and drive 
specifier. No wildcards are allowed. If no drive specifier or path 
designation exists, the function accesses the current drive or directory. 


Only EXE or COM programs can be executed. To execute a batch file, 
the command processor (COMMAND.COM) must be called using the /c 
parameter followed by the name of the batch file. 
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The parameter block must have the following format: 


Bytes 0-1: | Environment block segment address 
Bytes 2-3: | Command parameter offset address 
Bytes 4-5: | Command parameter segment address 
Bytes 6-7: First FCB offset address 

Bytes 8-9: First FCB segment address 

Bytes 10-11: Second FCB offset address 

Bytes 12-13: Second FCB segment address 


If the segment address of the environment block is a 0, the called program 
has the same environment block as the calling program. 


The command parameters must be stored so that the parameter string 
begins with a byte representing the number of characters in the command 
line. Next follow the individual ASCII characters, which are terminated 
by a carriage retum (ASCII code 13) (this carriage return is not counted as 
a character). 


The first FCB passed is copied to the PSP of the called program starting 
at address SCH. The second FCB passed is copied to the PSP of the called 
program starting at address 6CH. If the called program does not obtain 
information from the two FCBs, any desired value can be entered into the 
FCB fields at the parameter block. 


After the call of this function, all registers are destroyed except the CS 
and IP registers. For later recall, save their contents before the function 


call. 
The program called should have all the handles available to the calling 
program. 
Interrupt 21H, function 4BH, sub-function 3 DOS 
Execute overlay (Version 2 and up) 


Loads a second program into memory as an overlay without automatically 
executing the second program. 


Input: AH = 4BH 
AL= 3 
ES = Parameter block segment address 
BX= Parameter block offset address 
DS = Program name segment address 
DX = Program name offset address 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
AX=2: Path or program not found 
AX=5: Access denied 
AX=8: Insufficient memory 
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AX=10: Wrong environment block 
AX=11: Incorrect format 


The directory name passed is an ASCII string which is terminated by an 
end character (ASCII code 0). It can contain a path designation and drive 
specifier. No wildcards are allowed. If no drive specifier or path 
designation exists, the function accesses the current drive or directory. 


Only EXE or COM programs can be executed. To execute a batch file, 
the command processor (COMMAND.COM) must be called using the /c 
parameter followed by the name of the batch file. 


The parameter block must have the following format: 


Byte 0-1: Segment address where the overlay will be stored 
(offset address=0) 
Byte 2-3: Relocation factor 


The relocation factor requires the value 0 for COM programs. Use the 
segment address at which the program should load when accessing EXE 


programs. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 4CH DOS 
Terminate with return code (Version 2 and up) 


Terminates a program and passes an end code for which function 77 (4DH-see 
below) searches. This function releases the memory previously occupied by the 


terminated program. 
Input: AH= 4CH 
AL= Return code 
Output: No output 
Remarks: This function may be used for program termination instead of the other 


functions listed earlier. 


This function call restores the contents of the three interrupt vectors that 
were stored in the PSP when the program started execution. 


Before passing control to the calling program, all handles opened by this 
program close, along with the corresponding files. This is not applicable 
to files accessed using FCBs. 


A batch file can test for the return code using the ERRORLEVEL and IF 
batch commands. 
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Interrupt 21H, function 4DH DOS 
Get return code (Version 2 and up) 


Checks a program, called from another program by the EXEC function, for the 
return code passed by the called program when it terminates. 


Input: AH = 4DH 


Output: AH = Type of program termination 
AH=0: Normal end 
AH=1: End through <Ctrl><C> or <Break> 
AH=2: Device access error 
AH=3: Call of function 49 (31H) 
AL= Return code 


Remarks: This function reads the return code of the called program only once. 


The contents of the AX, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
flag registers are not affected by this function. The contents of all other 


registers may change. 
Interrupt 21H, function 4EH DOS 
Search for first match (Version 2 and up) 


Searches for the first occurrence of the filename listed. The file can have certain 
attributes, so a search can be made through subdirectories and volume names. 


Input: AH = 4EH 
CX = File attribute 
DS = Filename segment address 
DX = Filename offset address 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=2: Path not found 
AX=18: No file with the attribute found 


Remarks: The directory name passed is an ASCII string which is terminated by an 
end character (ASCII code 0). It can contain a path designation and drive 
specifier. No wildcards are allowed. If no drive specifier or path 
designation exists, the function accesses the current drive or directory. 


The search defaults to normal files (attribute 0). Any set attribute bits 
extends the search to normal files and any other file types. 


If a matching file occurs, the first 43 bytes of the DTA contain the 
foliowing information about this file: 


Bytes 0-20: Reserved 
Byte 21: File attribute 
Bytes 22-23: Time of last modification to file 
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Bytes 24-25: Date of last modification to file 

Bytes 26-27: Low word of file size 

Bytes 28-29: High word of file size 

Bytes 30-42: ASCII filename and extension terminated 
by an end character (ASCII code 0) 


This function may only be called to search for the first occurrence of a 
file. If you want to search for a group of files using wildcards, function 
4FH (see below) must be called. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 4FH | DOS 
Search for next match (handle) (Version 2 and up) 


Searches for subsequent occurrences of the filename listed after function 78 (above) 


executed successfully. 
Input: AH = 4FH 
Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX=Enrror code) 
AX=18: No other files found with this attribute 
Remarks: If a matching file occurs, the first 43 bytes of the DTA contain the 


following information about this file: 


Bytes 0-20: Reserved 

Byte 21: File attribute 

Bytes 22-23: Time of last modification to file 

Bytes 24—25: Date of last modification to file 

Bytes 26-27: Low word of file size 

Bytes 28-29: High word of file size 

Bytes 30-42: ASCII filename and extension terminated 
by an end character (ASCII code 0) 


This function can only be called if function 4EH has been called once and 
if the DTA remains unchanged. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 54H DOS 
Get verify flag (Version 2 and up) 


Gets the current status of the verify flag. This flag determines whether or not data 
transmitted to a medium (floppy disk or hard disk) should be verified after the 


transmission. 
Input: AH= 44H 
Output: AL= Verify flag 
AL=0: Verify off 
AL=1: Verify on 
Remarks: Function 2EH (see above) controls the status of the verify flag. 


The contents of the AH, BX, CX, DX, SI, DI, BP, CS, DS, SS, ES and 
flag registers are not affected by this function. 


Interrupt 21H, function 56H DOS 
Rename file (handle) (Version 2 and up) 


Renames a file or moves the file to another directory of a block device. Moving is 
possible only within the different directories of one particular device (i.e., you can't 
move a file from a hard disk directory to a floppy disk directory). 


Input: AH = 56H 
DS = Old filename segment address 
DX = Old filename offset address 
ES = New filename segment address 
DI= New filename offset address 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=2: File not found 
AX=3: Path not found 
AX=5: Access denied 
AX=11: Not the same device 


Remarks: The directory name passed is an ASCII string which is terminated by an 
end character (ASCII code 0). It can contain a path designation and drive 
specifier. No wildcards are allowed. If no drive specifier or path 
designation exists, the function accesses the current drive or directory. 

An error occurs if you attempt to move the file to a filled root directory. 
This function cannot access subdirectories or volume names. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 57H, sub-function 0 DOS 
Get file date and time (Version 2 and up) 


Gets the date and time of the creation or last modification of a file. 


Input: AH= 57H 
AL= 0 
BX= Handle 


Output: Carry flag=0: O.K. 
CX=Time 
DX= 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function 
AX=6: Invalid handle 


Remarks: In order for it to be accessed with a handle, the file must have been 
previously opened or created using one of the handle functions. 


The time appears in the CX register in the following format: 


Bits 0-4: Seconds in 2-second increments 
Bits 5-10: | Minutes 
Bits 11-15: Hours 


The date appears in the DX register in the following format: 


Bits 0-4: Day of the month 
Bits 5-8: Month 
Bit 9-15: Year (relative to 1980) 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 57H, sub-function 1 DOS 
Set file date and time (Version 2 and up) 


Stores the date and time of the creation or last modification of a file in the 
corresponding file and device. 


Input: AH = 57H . 
AL= 1 
BX= Handle 
CX = Time 
DX = Date 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function 
AX=6: Invalid handle 
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Remarks: In order to be accessed with a handle, the file must have been eres 
opened or created using one of the handle functions. 


The time appears in the CX register in the following format: 


Bits 0-4: Seconds in 2-second increments 
Bits 5-10: § Minutes 
Bits 11-15: Hours 


The date appears in the DX register in the following format: 


Bits 0-4: Day of the month 
Bits 5-8: Month 
Bit 9-15: Year (relative to 1980) 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 58H, sub-function 0 DOS 
Get allocation strategy (Version 3 and up) 


Determines the method currently in use by MS-DOS for allocating blocks of 
memory. If a program allocates memory using function 48H, different programs in 
memory may already have memory blocks assigned to them. Since these requested 
memory blocks vary in size, DOS has three methods of allocating memory to a 


program: 


° First fit: DOS starts searching at the start of memory and allocates the 
first memory block it finds of the requested size; 


° Best fit: DOS searches all available memory blocks and allocates the 
smallest suitable memory block it finds (the most efficient method); 


. Last fit: DOS starts searching at the end of memory and allocates the first 
memory block it finds of the requested size. 


Input: AH= 58H 
AL= 0 


Output: Carry flag=0: O.K. 
AX=0: First fit (start from beginning of memory) 
AX=1: Best fit (search for best-fitting memory block) 
=2: Last fit (start from end of memory) 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 


Remarks: The allocation strategy applies to all programs. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 58H, sub-function 1 DOS 
Set allocation strategy (Version 3 and up) 


Defines the method currently in use by MS-DOS for allocating blocks of memory. 
If a program allocates memory using function 48H, different programs in memory 
may already have memory blocks assigned to them. Since these requested memory 
blocks vary in size, DOS has three methods of allocating memory to a program: 


° First fit: DOS starts searching at the start of memory and allocates the 
first memory block it finds of the requested size; 


° Best fit: DOS searches all available memory blocks and allocates the 
smallest suitable memory block it finds (the most efficient method); 


° Last fit: DOS starts searching at the end of memory and allocates the first 
memory block it finds of the requested size. 


Input: AH= 58H 
AL= 1 
BX= Allocation strategy 
BX=0: First fit (start from beginning of memory) 
BX=1: Best fit (search for best-fitting memory block) 
BX=2: Last fit (start from end of memory) 


Output: Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function number 
Remarks: The allocation strategy applies to all programs. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 
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Interrupt 21H, function 59H DOS 
Get extended error information (Version 3 and up) 


Gets information about errors that occur during the call of one of the functions of 
either interrupt 21H or interrupt 24H. This information includes detailed 
information about the error, its origin and the action the user should take to 
alleviate the error. 


Input: AH = 59H 
BX= 0 
Output: AX = Description of error 
BH= Cause of error 
BL= Recommended action 
CH = Source of error 
Remarks: The following codes describe the error: 
CLC CERN 2 5) Sc a ae ae eke ee eee et cee ae 
0: No error 
| Invalid function number 
2: File not found 
3: Path not found 
4: Too many files open at once 
5: Access denied 
6: Invalid handle 
i Memory control block destroyed 
8: Insufficient memory 
9: Invalid memory address 
10: Invalid environment 
11: Invalid format 
12: Invalid access code 
13: Invalid data 
14: Reserved 
15: Invalid drive 
16: Current directory cannot be removed 
17: Different device 
18: No additional files 
19: Medium write protected 
20: Unknown device 
21: Device not ready 
22: Unknown command 
23: CRC error 
24: Bad request structure length 
25: Seek error 
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Code Error 


26: Unknown medium type 
pe bs Sector not found 

28: Printer out of paper 

29: Write error 

30: Read error 

31: General failure 

32: Sharing violation 

33: Lock violation 

34: Unauthorized disk change 
35: FCB not available 

80: File already exists 

81: Reserved 

82: Directory cannot be created 
83: Terminate after call of interrupt 24H 


The following codes describe the cause of the error: 


Code Error 

No memory available on the medium 

Temporary access problem—may end soon 

Access unauthorized 

Internal error in system software 

Hardware error 

Software failure not caused by running application program 
Application program error 

File not found 

Invalid file format/type 

10: File locked 

11: Wrong medium in drive, bad disk or medium problem 
12: Other error 


SS ee 


The following codes describe the action needed to fix the error: 


G11 a © 6 (0) a a a a a cn ne ne ene 
1: Repeat process several times, then ask user to abort/ignore 
2: Repeat process several times pausing each time, then ask 
user to abort/ignore 

Ask user for correct information (e.g., filename) 
Terminate program as completely as possible 

Terminate program NOW (no file closing, etc.) 

Ignore error 

Ask user to remove error source and repeat process 


Oo ee 
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The following codes describe the source of the error: 


1: Unknown 

2: Block device (disk drive, hard disk, etc.) 
3: Network 

4: Serial device 

oS RAM 


The contents of the CS, DS, SS and ES registers are not affected by this 
function. All other register contents are destroyed. 


Interrupt 21H, function 5AH DOS 
Create temporary file (handle) (Version 3 and up) 


Creates a temporary file in memory for storage during program execution. The 
filename doesn't matter because the access occurs through the assigned handle. 
Since this function allows several files open at the same time, DOS creates 
filenames from the current date and time. Every temporary file is ensured its own 
particular name because the function cannot be called more than once at a time. 


Input: 


Output: 


Remarks: 
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AH= 5AH 

CX = File attribute 

DS = Directory segment address 
DX = Directory offset address 


Carry flag=0: O.K. 
AX=Handle 
DS=Complete filename segment address 
DX=Complete filename offset address 
Carry flag=1: Error (AX = Error code) 
AX=3: Path not found 
AX=5: Access denied 


The directory name passed is an ASCII string which is terminated by an 
end character (ASCII code 0). It can contain a path designation and drive 
specifier. No wildcards are allowed. If no drive specifier or path 
designation exists, the function accesses the current drive or directory. 


The bits of the file attribute have the following meanings: 


Bit 0 = 1: Read only file 
Bit 1 = 1: Hidden file 
Bit 2 = 1: System file 


Temporary files are not automatically deleted after program execution. 
The file must be closed using function 3EH, then the temporary file must 
be deleted using function 41H. 
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The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. 


Interrupt 21H, function 5BH DOS 
Create new file (handle) (Version 3 and up) 


Creates a file in the specified directory based upon an ASCII file format. If no drive 
specifier or path is provided, the file opens in the default (current) directory. 


Input: AH= 5BH 
CX = File attributes: 
CX=00: Normal file 
CX=01: Read-only file 
CX=02: Hidden file 
CX=04: System file 
DS = ASCII file specification segment address 
DX = ASCII file specification offset address 


Output: Carry flag=0 (AX= file handle) 
Carry flag=1 (AX = Error code) 
AX=3: Path not found 
AX=4: No handle available 
AX=5: Access denied 
AX=80 (SOH): File already exists 


Remarks: An error occurs when any element of the path designation doesn't exist, 
when the filename already exists in the specified directory, or when an 
attempt is made to create the file in an already full root directory. 


The file defaults to the normal read/write attribute, which allows both read 
and write operations. This attribute can be changed by using function 


43H. 
Interrupt 21H, function 5CH DOS 
Control record access (Version 3 and up) 


Locks or unlocks a particular section of a file. This function operates on 
multitasking and networking systems. 


Input: AH= 5CH 
AL= Function code 
AL=00: Lock file section 
AL=01: Unlock file section 
BX= File handle 
CX = High word of section offset 
DX = Low word of section offset 
SI= High word of section length 
DI= Low word of section length 
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Output: Carry flag=0: Successful lock/unlock 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function code 
AX=6: Invalid handle 
AX=33 (21H): All or part of section already locked 


Remarks: | This function can only be used on files already opened or created using 
functions 3CH, 3DH, SAH or S5BH. 


The corresponding call to unlock a file region must contain the identical 
file offset and file region length. 


Interrupt 21H, function SEH, sub-function 0 pos 
Get machine name (Version 3.1 and up) 


Returns the address of an ASCII string which defines the local computer type 
within a network. 


Input: AH= SEH 
AL= 00 
DS = User buffer segment address 
DX = User buffer offset address 


Output: Carry flag=0: Successful execution 
CH = 00: Name undefined 
CH > 00: Name defined 
CL= NETBIOS name number (when CH<>00) 
DS = Identifier segment address (when CH<>00) 
DX = Identifier offset address (when CH<>00) 
Carry flag=1: Error (AX = Error code) 

AX=1: Invalid function code 


Remarks: The computer type is a 15-byte-long string terminated by an end character 
(ASCII code 0). 

Interrupt 21H, function 5EH, sub-function 2 DOS 

Set printer setup (Version 3.1 and up) 


Specifies a string which precedes all output to a particular printer used by a 
network. This string allows network users to assign their own individual printing 


parameters to the shared printer. 
Input: AH= 5EH 
AL= (2 


BX= Redirection list index (see Remarks below) 
CX = Printer setup string length 

DS = Printer setup string segment address 

SI= Printer setup string offset address 
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Output: Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function code 


Remarks: The contents of register BX (redirection list index) come from function 94 
5EH, sub-function 2. Function 5EH, sub-function 3 (see below) can 
supply the current printer setup string. 


Interrupt 21H, function SEH, sub-function 3 DOS 
Get printer setup (Version 3.1 and up) 


Gets the printer setup string assigned to a particular network printer by using 
function SEH, sub-function 2 (see above). 


Input: AH = SEH 
AL= 03 
BX= Redirection list index) 
DS = Setup string receiving buffer segment address 
SI= Setup string receiving buffer offset address 


Output: Carry flag=0: Successful execution 
CX=Printer setup string length 
ES=Segment address of buffer retaining setup string 
DI=Offset address of buffer retaining setup string 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function code 


Remarks: The contents of register BX (redirection list index) come from function 


SEH, sub-function 2. Function SEH, sub-function 3 can supply the 
current printer setup string. 


Interrupt 21H, function 5FH, sub-function 2 DOS 
Get redirection list entry (Version 3.1 and up) 


Gets the system redirection list. This list assigns local names to network printers, 


files or directories. 
Input: AH = 5FH 
AL= 02 


BX= Redirection list index (see Remarks below) 

DS = Device name buffer segment address (16 bytes) 
SI= Device name buffer offset address (16 bytes) 

ES = Network name buffer segment address (128 bytes) 
DI= Network name buffer offset address (128 bytes) 
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Output: 


Remarks: 


Carry flag=0: Successful execution 
BH= Status flag 

0: Valid device 

1: Invalid device 
BL= Device type 

3: Printer 

4: Drive 
BP = Destroyed 
CX = Parameter value in memory 
DX = Destroyed 
DS = ASCII format local device name segment address 
SI= ASCII format local device name offset address 
ES = ASCII format network name segment address 
DI= ASCII format network name offset address 
Carry flag=1: Error (AX = Error code) 

AX=1: Invalid function code 

AX=18: No more files available 


The contents of register CX come from function 5FH, sub-function 3 (see 
below). 


Interrupt 21H, function SFH, sub-function 3 DOS 
Redirect device — (Version 3 and up) 


Redirects device access in a network, assigning a network name to a local device. 


Input: 


Output: 


Remarks: 
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AH= 5FH 
AL= 03 
BL= Device type 
BL=3: Printer 
BL=4: Drive 
CX = Parameter value in memory 
DS = ASCII format local device name segment address 
SI= ASCII format local device name offset address 
ES = ASCII format network name and password segment address 
DI= ASCII format network name and password offset address 


Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function code; string format incorrect; 
device redirected 
AX=3: Path not found 
AX=5: Access denied 
AX=8: Insufficient memory 


The contents of register CX are supplied from function S5FH, sub-function 
3; | 


Device names can be drive specifiers (e.g., A:), printer names (i.e., LPT1, 
PRN, LPT2 or LPT3) or null strings. If you enter a null string and pass- 
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word as the device name, DOS tries to open access to the network using 


the password. 
Interrupt 21H, function 5FH, sub-function 4 DOS 
Cancel redirection (Version 3 and up) 


Disables the current redirection by removing local name assignments to network 
printers, files or directories. 


Input: AH= 5FH 
AL= (4 
BX= Redirection list index (see Remarks below) 
DS = ASCII format local device name segment address 
SI= ASCII format local device name offset address 


Output: Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function code; device name not on network 
AX=15: Redirection halted 


Remarks: Device names can be drive specifiers (e.g., A:), printer names (i.e., LPT 1, 
PRN, LPT2 or LPT3) or strings beginning with double backslashes (.e., 
\). A string preceded by two backslashes terminates communications 
between the local computer and the network. 


Interrupt 21H, function 62H DOS 
Get PSP address (Version 3 and up) 


Gets the segment address of the PSP from the currently executing program. 


Input: AH= 62H 
Output: BX= PSP segment address 
Remarks: The PSP starts at address BX:0000. 


The contents of the AX, CX, DX, SI, DI, BP, CS, DS, SS, ES registers 
and the flag registers are not affected by this function. 
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Interrupt 21H, function 63H, sub-function 0 DOS 
Get lead byte table (Version 2.25 only) 
Gets the address of the system table which defines the byte ranges for the PC's 
extended character sets. 
Input: AH= 9963H 
AL= 00: Get address of system lead byte table 
Output: DS = Table segment address 
SI= Table offset address 
Remarks: This function is available only in DOS Version 2.25. 
Interrupt 21H, function 63H, sub-function 1 DOS 
Set or clear interim console flag (Version 2.25 only) 


Clears the interim console flag. 


Input: AH= 63H 
AL= 01: Clear or set interim console flag 
DL = Interim console flag setting 
DL=01: Set interim console flag 
DL=00: Clear interim console flag 


Output: No output 

Remarks: This function is available only in DOS Version 2.25. 

Interrupt 21H, function 63H, sub-function 2 DOS 
Get interim console flag (Version 2.25 only) 


Gets the interim console flag. 


Input: AH= 63H 
AL= (2: Get interim console flag value 


Output: DL= Flag value 

Remarks: This function is available only in DOS Version 2.25. 

Interrupt 21H, function 64H DOS 
Reserved (Version 3 and up) 
Interrupt 21H, function 65H DOS 
Get extended country information (Version 3.3 and up) 


Gets information about the specific country/code page. 


Input: AH = 65H 
AL = sub-function: 
AL = 1: Get international information 
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Remarks: 
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AL = 2: Get uppercase pointer table 
AL = 4: Get pointer to uppercase pointer table (filename) 
AL = 6: Get pointer to collation table 

BX= Code page: 

BX = -1: active CON device 

CX = Length of buffer allocated to receive information 

DX = Country ID number 

DX = -1: Default 

ES:DI = Address of buffer allocated to receive information 


Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 


The information this function returns is an extended version of the 
information returned by int 21H, function 38H. 


An error may occur if the country code in DX is invalid, or if the code 
page number is different from the country code, or if the buffer length 
specified in the CX register is less than five bytes. If the buffer is not 
long enough to receive all the information, the function accepts as much 
information as the buffer will accept. This buffer contains the following 
information after the call: 


Byte 0: ID code for information 

Bytes 1-2: Length of buffer 

Bytes 3-4: Country ID 

Bytes 5-6: Code page 

Bytes 7-8: Date format 

0 = USA: Month-day-year 

1 = Europe: Day-month-year 

2 = Japan: Year-month-day 

Bytes 9-13: Currency indicator 

Bytes 14-15: ASCII code of the thousand character (comma/period) 
Bytes 16-17: ASCII code of the decimal character (period/comma) 
Bytes 18-19: ASCII code of the date separation character 
Bytes 20-21: ASCII code of the time separation character 
Byte 22: Currency format 

bit 0 = 0: Currency symbol before the value 

bit 0 = 1: Currency symbol after the value 

bit 1 = 0: No spaces between value and currency symbol 
bit 1 = 1: Space between value and currency symbol 
Byte 23: Precision (number of decimal places) 

Byte 24: Time format 

bit O = 0: 12-hour clock 

bit 0 = 1: 24-hour clock 

Bytes 25-28: Address of character conversion routine 
Bytes 29-30: ASCII data separator 

Bytes 31-40: Reserved 
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Interrupt 21H, function 66H DOS 
Get or set code page (Version 3.3. and up) 


Gets or sets the current code page. 


Input: AH= 66H 
AL= sub-function: 
AL = 1: Get code page 
AL = 2: Select code page 
BX= Selected code page (if AL = 2) 


Output: Carry flag=0: Successful execution 
If AL =1 used for input: 
BX = active code page 
DX = default code page 
Carry flag=1: Error (AX = Error code) 


Remarks: If sub-function 2 is used, COUNTRY.SYS supplies the code page 
number. 


The DEVICE... (CONFIG.SYS), NLSFUNC and MODE CP PREPARE 
commands (AUTOEXEC.BAT) must have already configured the system 
for code page switching before this function may be called. 


Interrupt 21H, function 67H DOS 

Set handle count : (Version 3.3 and up) 
Sets the maximum number of accessible files and devices that may be currently 
opened using handles. 

Input: AH = 67H 


BX= Number of handles desired 


Output: Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 


Remarks: The PSP's default table reserved for the process can control 20 handles. 


An error occurs if the content of the BX register is greater than 20, or if 
insufficient memory exists to allocate a block for the extended table. 


If the number in the BX register is greater than the number of entries 
assigned by the FILES entry in the CONFIG.SYS file, no error occurs. 
However, attempts at opening a file or device fail if all file entries are in 
use, even if file handles are still available. 


Interrupt 21H, function 68H DOS 
Commit file (Version 3.3 and up) 


Writes all DOS buffers associated to a specific handle to the specified device. If the 
handle points to a file, the file's contents, date and size are updated. 
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Input: AH= 68H 
BX= File handle 
Output: Carry flag=0: Successful execution 


Carry flag=1: Error (AX = Error code) 


Remarks: This function performs the same task as closing and reopening a file or 
duplicate handle, even without handles. If this function accesses a 
character device's handle, the carry flag returns 0 but nothing else 


happens. 


Multiprocessing and networking applciations maintain control of the file. 


Interrupt 22H DOS 
Terminate address (Version I and up) 


Contains the address of a routine which terminates a program. Control returns to 
the program that called for termination. You should never call this routine directly. 


DOS stores the contents of this interrupt vector in the PSP of the program to be 
executed before passing control to the program. This prevents program changes to 
the vector, which could prevent DOS from calling the termination routine. 


Interrupt 23H DOS 
<Ctrl><C> handler address (Version 1 and up) 


Contains the address of a routine which executes when the user presses <Ctrl><C> 
or <Ctrl><Break>. You should never directly call this routine. 


DOS stores the contents of this interrupt vector in the PSP of the program to be 
executed before passing control to the program. This prevents program changes to 
the vector, which could prevent DOS from calling the termination routine. 


Interrupt 24H DOS 
Critical error handler address (Version 1 and up) 


Represents a routine called during hardware access (e.g., disk drive) when a critical 
error occurs. You should never directly call this routine. 


When an application routine is called during a critical error, bit 7 of the AH 
register indicates the type of failure (0 = disk/hard disk error, 1= other errors). A 
disk/hard disk error will only be reported after several attempted accesses. During 
the call, the DI register receives one of the following codes: 


Disk write protected 
Access on unknown device 
Drive not ready 

Invalid command 

CRC error 

Bad request structure length 
Seek error 

Unknown device type 


eee Se 
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8: Sector not found 

9; Printer out of paper 
10: Write error 

11: Read error 

12: General failure 


The error routine restores the SS, SP, DS, ES, BX, CX and DX registers to the 
same values that they contained during the call. During execution it can only 
access functions 1 to OCH of interrupt 21H. It should be terminated by an IRET 
instruction and pass one of the following codes to the AL register: 


0: Ignore error 

1: Repeat the operation 

2 Terminate program using interrupt 23H 
5: Fail system call (Version 3 and up only) 


If a program changes the content of this interrupt vector, the program can 
terminate without restoring the memory contents. Since RAM can be released and 
used by other programs, the critical error routine can be overwritten by another 
program in memory. When this occurs, a critical error could cause a system crash 
because a completely different code now exists at the location of the old error 
handler routine. 


Before passing control to the program, DOS stores the contents of this interrupt 
vector in the PSP of the program to be executed. This prevents program changes 
to the vector, which could prevent DOS from calling the termination routine. 
During program termination, the contents of the interrupt vector pass from the 
PSP to the vector; then the system calls the routine. 


Interrupt 25H DOS 
Absolute disk read ‘Version 1 and up) 


Input: 


Output: 


844 


Reads one or more consecutive sectors from a disk or hard disk. 


= Drive specifier 
CX= Number of sectors to read 
DX= First sector to read 
DS= _ Buffer segment address 
BX= Buffer offset address 


Carry flag=0: O.K. 
Carry flag=1: Error (AX = Error code) 
AX=1: Bad command 
AX=2: Bad address 
AX=4: Sector not found 
AX=8: DMA error 
AX=16: CRC error 
AX=32: Disk controller error 
AX=64: Seek error 
AX=128: Device does not respond 
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Remarks: 
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In the AL register 0 represents drive A:, 1 represents drive B:, etc. 


All the sectors of the medium can be accessed. DOS itself uses this 
interrupt to read the root directory and the FAT of a medium. The data are 
read from the medium into the buffer of the calling program. After the 
function call, the contents of all registers, except the segment register, 
may change. 


After the interrupt call, the stack pointer changes position because two 
bytes stored on the stack during the call are removed and not returned. 
These bytes represent the flag register, which can be read from the stack 
using the POPF instruction. The old value of the stack pointer can be set 
by adding 2 to its contents. If you omit the stack pointer correction, the 
stack could overflow. Because of this, you cannot call this interrupt from 
higher level languages. You must call it from assembly language. 


The contenis of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. The contents of all other 
registers may change. 


DOS 


Absolute disk write (Version 1 and up) 


Writes one or more consecutive sectors to a disk or hard disk. 


Input: 


Output: 


Remarks: 


AL= Device designation 

CX = Number of sectors to be written 
DX = First sector to be written 

DS = Buffer segment address 

BX= Buffer offset address 


Carry flag=0: O.K. 

Carry flag=1: Error (AX = Error code) 
AX=1: Bad command 
AX=2: Bad address 
AX=3: Medium write protected 
AX=4: Sector not found 
AX=8: DMA error 
AX=16: CRC error 
AX=32: Disk controller error 
AX=64: Seek error 
AX=128: Device does not respond 


In the drive specifier 0 represents drive A:, 1 represents drive B:, etc. 


All the sectors of the medium can be accessed. DOS itself uses this 
interrupt to write the root directory and the FAT to a medium. The data 
are written from the buffer of the calling program to the medium. After 
the function call, the contents of all registers, except the segment register, 
may change. 
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After the interrupt call, the stack pointer changes position because two 
bytes stored on the stack during the call are removed and not returned. 
These bytes represent the flag register, which can be read from the stack 
using the POPF instruction. The old value of the stack pointer can be set 
by adding 2 to its contents. If you omit the stack pointer correction, the 
stack could overflow. Because of this, you cannot call this interrupt from 
higher level languages. You must call it from assembly language. 


The contents of the BX, CX, DX, SI, DI, BP, CS, DS, SS and ES 
registers are not affected by this function. The contents of all other 
registers may change. 


Interrupt 27H DOS 
Terminate and stay resident (Version 1 and up) 


Terminates the currently executing program and returns control to the program that 
called the current program. Unlike other functions used for program termination, 
the memory used by the current program keeps the program code for later recall. 


Input: CS = PSP segment address 
DX = Number of bytes + 1 to be reserved 
Output: No output 
Remarks: This function is only suitable for calling COM programs. 


The number of bytes to be reserved relates to the beginning of the PSP. 


The value in the DX register has no effect on memory blocks reserved by 
function 48H of interrupt 21H. 


An error occurs during the call of this interrupt if the value in the DX 
register ranges from FFF1H to FFFFH. 


This interrupt does not close open files. 


Interrupt 2FH, sub-function 0 DOS 
Get print spool install status (Version 3 and up) 


Gets current installation status of the print spooler. 


Input: AH= 2FH 
AL= 0 
Output: Carry flag=0: Successful execution 


AL= 0: O.K. to install 
AL= 1: Don't install 
AL= 255: Already installed 
Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function 
=2: File not found 
AX=3: Path not found 
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AX=4: Too many files currently open 
AX=5: Access denied 
AX=8: Print queue full 
=9: Print spooler busy 
AX=12: Name too long 
AX=15: Invalid drive 


Interrupt 2FH, sub-function 1 DOS 
Send file to print spooler (Version 3 and up) 


Passes a file to the print spooler. 


Input: AH = 2FH 
AL= 1 
DS = Print packet (see below) segment address 
DX = Print packet (see below) offset address 


Output: Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 

AX=1: Invalid function 
AX=2: File not found 
AX=3: Path not found 
AX=4: Too many files currently open 
AX=5: Access denied 
AX=8: Print queue full 
AX=9: Print spooler busy 
AX=12: Name too long 
AX=15: Invalid drive 


Remarks: The five-byte print packet contains print spooler information. The first 
byte indicates the DOS version (0=Versions 3.1 to 3.3); the remaining 
bytes indicate the segment and offset addresses of the file specification. 


Interrupt 2FH, sub-function 2 DOS 
Remove file from print queue (Version 3 and up) 


Deletes a file from the print spooler queue. 


Input: AH= 2FH 
AL= 2 
DS = ASCII-format file segment address 
DX = ASCII-format file offset address 


Output: Carry flag=0: Successful execution 
Carry flag=1: Error (AX = Error code) 

AX=1: Invalid function 
AX=2: File not found 
AX=3: Path not found 
AX=4: Too many files currently open 
AX=5: Access denied 
AX=8: Print queue full 
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AX=9: Print spooler busy 
AX=12: Name too long 
AX=15: Invalid drive 


Remarks: This sub-function allows wildcards (? and *) in file specifications, 
allowing you to delete more than one file at a time from the print queue. 


Interrupt 2FH, sub-function 3 DOS 
Cancel all files in print queue (Version 3 and up) 


Cancels all files waiting in the print spooler queue for printing. 


Input: AH= 2FH 
AL= 3 
Output: Carry flag=0: Successful execution 


Carry flag=1: Error (AX = Error code) 
AX=1: Invalid function 
AX=2: File not found 
AX=3: Path not found 
AX=4: Too many files currently open 
AX=5: Access denied 
AX=8: Print queue full 
AX=9: Print spooler busy 
AX=12: Name too long 
AX=15: Invalid drive 


Interrupt 2FH, sub-function 4 DOS 
Hold print jobs for status check (Version 3 and up) 


Halts all print jobs while testing for spooler status. 


Input: AH = 2FH 
AL= 4 
Output: Carry flag=0: Successful execution 


Carry flag=1: Error 

DX = Number of errors 

DS = Print queue segment address 
SI= Print queue offset address 


Remarks: The print queue segment and offset addresses point to a set of 64-byte 
filenames in the queue. Each entry contains an ASCII file specification. 


The first filename in the queue is the file currently printing in the print 
spooler. The last filename in the queue has a zero in the first byte of the 
specification. 
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Interrupt 67H, function 1H LIM/EMS 
Extended memory: Get status 


Returns the error status of the EMM after calling any EMS functions. 


Input: AH = 40H 
Output: AH = EMM status 
=Q0H: O.K. 


AH=80H: Intemal error, EMM possibly destroyed 
AH=81H: EMS hardware error 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 
This function should be the first EMM call a program makes, to ensure 
that the hardware and software are functioning properly. 


Interrupt 67H, function 2H LIM/EMS 
Extended memory: Get segment address of the page frame 


Determines the segment address of the page frame. 


Input: AH= 41H 

Output: AH= 0: O.K. 
BX= Page frame segment address 
AH > 0: Error 


AH=80H: Intemal error, EMM possibly destroyed 
AH=81H: EMS hardware error 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 
The addresses of the four physical pages can be calculated from this 
segment address, whereby the first page starts at address 
PAGE_FRAME:0000. The three other pages follow at 16K intervals. 
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Interrupt 67H, function 3H LIM/EMS 
Extended memory: Get number of EMS pages 


Informs the calling program how many 16K EMS pages are installed, and how 
many EMS pages are still availabie or unallocated. 


Input: AH = 42H 


Output: AH= 0: O.K. 
BX= Number of free (unallocated) pages 
DX = Total number of EMS pages 
AH > 0: Error 
AH=80H: Internal error, EMM possibly destroyed 
AH=81H: EMS hardware error 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The number of kilobytes of free EMS memory can be calculated by 
multiplying the number of free pages by 16. 


Interrupt 67H, function 4H LIM/EMS 
Extended memory: Allocate EMS memory 


Allocates a given number of 16K EMS pages for later access. 


Input: AH= 43H 
BX= Number of logical (16K) pages to be allocated 


Output: AH = 0: O.K. 
DX = Handle for accessing allocated memory 
AH > 9: Error 


AH=80H: Internal error, EMM possibly destroyed 
AH=81H: EMS hardware error 

AH=85H: No more handles available 

AH=87H: Not enough pages free 

AH=88H: No pages were requested 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The handle returned can be used for future access and for releasing the 
allocated memory. If this handle is "lost", the handle cannot be recovered, 
nor can memory be released or used by other programs. 


A call to this function may fail because there are not enough pages free or 
because the EMM has been called so often that no more handles are 
available. 


The handles normally have the numbers FFOOH, FEO1H, FD02H, 
FCO3H, etc. 
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Interrupt 67H, function 5H LIM/EMS 
Extended memory: Set mapping 


Places one of the pages previously allocated by function 4H in one of the four 
physical pages within the page frame. 


Input: AH= 44H 
AL= Physical page number (0 to 3) 
BX= Logical page number 


DX= Handle 
Output: AH = Error status 
AH=00H: O.K. 


AH=80H: Internal error, EMM possibly destroyed 
AH=81H: EMS hardware error 
AH=83H: Invalid handle 
=8AH: Invalid logical page 
AH=8BH: Invalid physical page 
Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The handle used when calling this function must have been returned by a 
previous call to EMM function 4H. 


The logical pages are numbered from 0 on, so that the value 0 must be 
passed to access the first logical page. The largest value allowed is the 
number of allocated pages minus one. 


Before accessing the physical page, the segment address of the page frame 
must be determined with function 2H. 


Interrupt 67H, function 6H LIM/EMS 
Extended memory: Release pages 


Releases pages allocated with function 4H to the EMM. This makes these pages 
available to other applications. 


Input: AH= 45H 
DX = Handle 
Output: AH = Error status: 
AH=O00H: O.K. 


AH=80H: Internal error, EMM possibly destroyed 
AH=81H: EMS hardware error 

AH=83H: Invalid handle 

AH=85H: Error while saving and restoring mapping 
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Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The handle used when calling this function must have been returned by a 
previous Call to EMM function 4H. 


All of the pages allocated to this handle are released by this function. It is 
impossible to release individual pages. 


After a successful call to this function the handle is no longer valid and 
cannot be used for accessing EMS memory. 


If the function returns an error, you should repeat the call at least three 
times or the pages will remain allocated and will not be available for 
other programs. 


Interrupt 67H, function 7H LIM/EMS 
Extended memory: Get EMM version | 


Determines the version number of the EMM (Expanded Memory Manager). 


Input: AH = 46H 

Output: AH= 0: O.K. 
AL= EMM version number 
AH > 0: Error 


AH=80H: Internal error, EMM possibly destroyed 
=81H: EMS hardware error 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The EMM version number is stored in the AL register as a BCD number, 
in which the upper four bits represent the version number preceding the 
decimal point and the lower four bits represent the version number 
following the decimal point. See also the demonstration programs in 
Chapter 13. 


Interrupt 67H, function 8H LIM/EMS 
Extended memory: Save mapping 


Saves current mapping between the four physical pages in the page frame and the 


associated logical pages. 
Input: AH= 47H 
DX = Handle 
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Output: AH = Error status 
AH=00H: O.K. 
AH=80H: Intemal error, EMM possibly destroyed 
AH=81H: EMS hardware error 
AH=83H: Invalid handle 
AH=8CH: Mapping memory full 
AH=8DH: Mapping for handle already stored, not restored using 
function 9H 


Remarks: Do not cali this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The handle used when calling this function must have been returned by a 
previous call to EMM function 4H. 


This function is intended for use within a TSR program or by the 
operating system in a multitasking environment, but can be used by any 


program. 


Interrupt 67H, function 9H LIM/EMS 
Extended memory: Restore mapping 


Restores mapping between the logical and physical pages saved by function 8H. 


Input: AH = 48H 
DX = Handle 
Output: AH = Error status: 
AH=00H: O.K. 


AH=80H: Intermal error, EMM possibly destroyed 

AH=81H: EMS hardware error 

AH=83H: Invalid handle 

AH=8EH: Mapping storage contains no entry for this handle 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The handle used when calling this function must have been returned by a 
previous call to EMM function 4H. 


Calling this function fails whenever the mapping for this handle has not 
been saved with function 8H, or the mapping has already been restored by 
a previous call to function 9H. 


This function is intended for use within a TSR program or by the 
operating system in a multitasking environment, but can be used by any 
program. 
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Interrupt 67H, function 0CH : LIM/EMS 
Extended memory: Get number of handles | 


Returns the number of memory blocks and the number of handles allocated by - 


function 4H. 
Input: AH = 4BH 
Output: AH = 0: O.K. 
BX= Number of allocated handles 
AH > 0: Error 
AH=80H: Internal error, EMM possibly destroyed 
AH=81H: EMS hardware error 
Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 
The number of allocated handles is not the same as the number of 
programs which are currently accessing the EMS memory. Each program 
can request an arbitrary number of EMS memory blocks/handles with 
function 4H. 
Interrupt 67H, function 0DH LIM/EMS 


Extended memory: Get number of allocated pages 


Returns the number of pages which have been allocated to the specified handle. 


Input: 


Output: 


Remarks: 
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AH= 4CH 
DX = Handle 


AH = 0: O.K. 
BX= Number of allocated pages 
AH > 0: Error 
AH=80H: Internal error, EMM possibly destroyed 
=81H: EMS hardware error 
AH=83H: Invalid handle 


Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


The number of allocated pages must range from 1 to 512. 
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Interrupt 67H, function OEH LIM/EMS 
Extended memory: Get all handles 


Loads the numbers of all active handles and the number of pages aliocated to each 
into an array. 


Input: AH = 48H 
ES = Segment address of array 
DI = Offset address of array 


Output: AH = 0: O.K. 
BX = Number of allocated logical pages 
AH > 0: Error 
AH=80H: Intemal error, EMM possibly destroyed 
AH=81H: EMS hardware error 


Remarks: Do not call this function unless you know that EMS memory and a 
corresponding EMM are installed (see Chapter 13 for more information). 


If the function returns successfully, the memory area to which the ES:DI 
register pair points will contain two words for each active handle. The 
first word contains the handle itself and the second word contains the 
number of pages allocated to the handle. The number of these entries is 
returned in the BX register. 


Since the EMM can manage a maximum of 256 handles, the array will 
never occupy more than 1024 bytes (1K). 
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Interrupt 10H, function 00H EGA/VGA 
Screen: Set video mode 


Sets and initializes the video mode. 


Input: 


Output: 
Remarks: 


AH= 00H 

AL= EGA video mode 

0: 40x25-character text, 16 colors (EGA/VGA - color monitor) 

1: 40x25-character text, 16 colors EGA/VGA - color monitor) 

2: 80x25-character text, 16 colors (EGA/VGA - color monitor) 

3: 80x25-character text, 16 colors (EGA/VGA - color monitor) 

4: 320x200 pixel graphics, 4 colors (EGA/VGA - color monitor) 

D2 320x200 pixel graphics, 4 colors (EGA/VGA - color monitor) 

6: 640x200 pixel graphics, 2 colors (EGA/VGA - color monitor) 

7: 80x25-character text, mono (EGA/VGA - mono monitor) 

13: 320x200 pixel graphics, 16 colors (EGA/VGA - color monitor) 

14: 640x200 pixel graphics, 16 colors (EGA/VGA - color monitor) 

15: 640x350 pixel graphics, mono (EGA/VGA - mono monitor) 

16: 640x350 pixel graphics, 4 colors (64K EGA-hi-res monitor) 
640x350 pixel graphics, 16 colors (128K EGA/VGA-hi-res 
monitor) 

17: 640x480 pixel graphics, 2 colors (VGA only) 

18: 640x480 pixel graphics, 16 colors (VGA only) 

19: 320x200 pixel graphics, 256 colors (VGA only) 

No output 


Modes 0 and 1, 2 and 3, 4 and 5 differ in the output of the color signal 
that is suppressed in the first mode. This isn't possible on an EGA/VGA 
card so the modes are identical. If bit 7 of the AL register is set when this 
function is Called, the contents of the video RAM will not be erased when 
the new mode is enabled. The task is to program the video controller and 
define a color palette. The contents of registers BX, CX, DX, SI, DI, BP 
and the segment registers are not affected by this function. 
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Interrupt 10H, function 01H EGA/VGA 
Screen: Define cursor appearance 


Defines the starting and ending lines of the screen cursor. This function is 
independent of the display page being displayed. 


Input: AH= 01H 
CH = Starting line of the cursor 
CL = Ending line of the cursor 


Output: No output 


Remarks: Since the possible values depend on the size of the current video mode's 
character matrix, the values in the CH and CL registers always refer to an 
eight-line character matrix. The values should thus be between zero and 
seven. The EGA/VGA BIOS adapts these values to the current size of its 
own character matrix. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 02H EGA/VGA 
Screen: Position cursor 


Moves the cursor into position on the screen. 
Input: AH= 02H 
BH= Video page number 
DH = Screen line 
DL= Screen column 
Output: No output 
Remarks: The cursor moves only if the specified display page is the current page. 


The values for the screen line and column are based on the resolution of 
the current display mode. 


Assigning the DH and DL registers values for a non-existent screen 
position (e.g., column 0, line 255) makes the cursor disappear from the 
screen. 


The number of the display page is based on how many display pages the 
card has available. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 03H EGA/VGA 
Screen: Read cursor position 


Reads the position of the text cursor on the screen and the starting and ending lines 
of the screen cursor. 


Input: AH= 03H 
BH= Video page number 


Output: DH = Screen line in which cursor is located 
DL= Screen column in which cursor is located 
CH = Starting line of screen cursor 
CL = Ending line of screen cursor 


Remarks: The screen line and screen column parameters refer to the text coordinate 
system, even if a graphic mode Is active. 


The starting and ending lines of the cursor are returned correctly only in 
the text modes. They have no meanings in graphic modes. 


The contents of registers BX, SI, DI, BP and the segment registers are not 
affected by this function. 


Interrupt 10H, function 05H EGA/VGA 
Screen: Select current display page 


Selects the current display page, and thereby the page which appears on the screen 


(text mode only). 
Input: AH= 05H 
AL= Display page number 
Output: No output 
Remarks: The number of available display pages depends on the amount of video 
RAM installed on the EGA/VGA card. 


When a new page is selected the screen cursor will be moved to the 
position of the text cursor on this page. 


Switching between different pages does not change the contents of these 
pages. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 06H EGA/VGA 
Screen: Scroll text lines up 


Scrolls part of the current display page up by one or more lines. 


Input: AH= 06H 

AL= Number of lines to be scrolled up 
AL=0: Clear window 

CH = Screen line of upper left corner of window 
CL = Screen column of upper left corner of window 
DH = Screen line of lower right corner of window 
DL= Screen column of lower right comer of window 
BH= Color (attribute) for blank line(s) 

Output: No output 

Remarks: Normally the contents of the current display page are scrolled, but in the 
320x200 four-color graphic mode this function only affects display page 
0. 
Clearing the screen window (number of lines = 0) is the same as filling it 
with spaces (ASCII code 32). 
The contents of the lines scrolled out of the window are lost and cannot 
be recovered. 
Use function 0 of this interrupt to clear the screen. 
The interpretation of the attribute byte in the BL register depends on the 
Current video mode. In text mode it is interpreted as any other attribute 
byte in video RAM. In 640x200 two-color mode this byte represents the 
color value for eight successive pixels. In 320x200 four-color mode this 
byte represents the color value of four successive pixels. In all other 
graphic modes it represents the color of all of the pixels in the cleared 
screen area. 
The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 

Interrupt 10H, function 07H EGA/VGA 


Screen: Scroll text lines down 


Scrolls part of the current display page down one or more lines. 


Input: 


AH = 07H 
AL= Number of lines to be scrolled down 

AL=0: Clear window 
CH = Screen line of upper left corner of window 
CL = Screen column of upper left corner of window 
DH = Screen line of lower right corner of window 
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Output: 
Remarks: 


DL= Screen column of lower right corner of window 
BH= Color (attribute) for blank line(s) 


No output 


Normally the contents of the current display page are scrolled, but in 
320x200 four-color graphic mode this function only affects display page 
0. 


Clearing the screen window (number of lines = 0) is the same as filling it 
with spaces (ASCII code 32). 


The contents of the lines scrolled out of the window are lost and cannot 
be recovered. 


To clear the entire screen, use function 0 of this interrupt instead. 


The interpretation of the attribute byte in the BL register depends on the 
current display mode. In the text mode it is interpreted like any other 
attribute byte in the video RAM. In the 640x200 two-color mode this 
byte represents the color value for eight successive pixels. In the 320x200 
four-color mode it represents the color value of four successive pixels. In 


all other graphic modes it represents the color of all of the pixels in the 


cleared screen area. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 08H EGA/VGA 
Screen: Read character/color 


Reads and returns the ASCII code and color (attribute) of the character at the current 


cursor position. 
Input: AH= 08H 
BH= Video page number 
Output: AL= ASCII code of character 
AH = Color (attribute) 
Remarks: This function can also be called in the graphic mode, whereby the bit 
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pattern of the character on the screen will be compared with the bit 
patterns of the characters. If the character cannot be identified, the AL 
register will contain the value zero after the call. 


In the 320x200 four-color graphic mode this function only affects display 
page 0. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 09H EGA/VGA 
Screen: Write character/color 


Writes character with the specified color at the current cursor position (in a 
specified display page). 


Input: AH = 09H 
BH= Video page number 
CX = Repeat factor 
AL= ASCII code of character 


BL= Attribute 
Output: No output 
Remarks: If the graphic mode is active and the specified character is to be printed 


more than once (the value of the CX register is greater than 1), all of the 
characters must fit on the current screen line. 


In the 320x200 four-color graphic mode this function correctly works 
only on display page 0. 


Within a graphic mode the attribute in the BL register specifies the 
foreground color of the character, whereby the background color is zero. If 
bit seven is set, the character will be XORed with the bitmap at the 
output position. 


The controls codes for bell, carriage return, etc. are not recognized as 
control codes, and are displayed as normal ASCII characters. 


This function can also be used to output characters in the graphic mode, 
in which case the character patterns are taken from one of the EGA 
character tables. 


This function does not move the cursor to the next screen position. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 0AH EGA/VGA 
Screen: Write character 


A character will be written to the current screen position on the specified display 
page and the color of the old character at this position will be retained. 


Input: AH = 0AH 
AL= ASCII code of the character 
BH= Video page number 
BL= Foreground color of character for graphic modes 
CX = Repeat factor 


Output: No output 
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Remarks: 


If the graphic mode is active and the specified character is to be printed 
more than once (the value of the CX register is greater than 1), all of the 
characters must fit on the current screen line. 


The controls codes for bell, carriage return, etc. are not recognized as such 
and are displayed as normal ASCII characters. 


This function can also be used to output characters in the graphic mode, 
in which case the character patterns are taken from one of the EGA 
character tables. 


Within a graphic mode the attribute in the BL register specifies the 
foreground color of the character, whereby the background color is zero. If 
bit seven is set, the character will be XORed with the bitmap at the 
output position. 


This function does not move the cursor to the next screen position. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function OBH, sub-function 0 EGA/VGA 
Screen: Select border/background color 


Selects the border and background color for the graphic or text mode. 


Input: AH= OBH 
BH= 0 
BL= Border/background color 

Output: No output 

Remarks: This function should be called only when the EGA/VGA card is in the 
320x200 or 640x200 graphic mode. Use function 10H for all other 
modes. 
Bits zero to three of the BL register set the background and border color. 
Setting bit four will enable high-intensity colors. 
The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 

Interrupt 10H, function OBH, sub-function 1 EGA/VGA 


Screen: Select color palette 


Selects one of the two color palettes for the 320x200 graphic mode. 


Input: 
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AH = 0BH 
BH= 1 
BL= Color palette number 
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Output: No output 

Remarks: This function should be called only when the EGA/VGA card is in the 
320x200 or 640x200 graphic mode. Use function 10H for all other 
modes. 


The EGA/VGA BIOS emulates the two CGA color palettes with the 
numbers 0 and 1. They contain the following colors: 


Palette 0: green, red, yellow 
Palette 1: cyan, magenta, white 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 0CH EGA/VGA 
Screen: Write pixel 


Sets the color value of a screen pixel in the graphic mode. 


Input: AH = 0CH 
BH= Video page 
DX = Screen line 
CX = Screen column 
AL= Color value 


Output: No output 
Remarks: The color value depends on the colors available in the current display 
mode. 


If bit seven of the AL register is set, the color value will be XORed with 
the previous color value of the pixel. 


The display page is ignored in the 320x200 four-color graphic mode. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 0DH EGA/VGA 
Screen: Read pixel 


The color value of a pixel in the graphic mode is returned. 
Input: AH = ODH 
BH= Video page 
DX = Screen line 
CX = Screen column 


Output: AL= Color value 
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Remarks: The color value depends on the colors available in the current display 
mode. 


The display page is ignored in the 320x200 four-color graphic mode. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 0EH EGA/VGA 
Screen: Write character 


Writes a character to the current cursor position on the current display page. The 
color of the old character at this position will be retained. 


Input: AH = 0EH 
AL= ASCII character code 
BL= Foreground color of character 


Output: No output 

Remarks: This function does not treat the various control codes like bell and 
Carriage as normal characters, and implements them as the control 
characters they represent. 


After displaying a character with this function, the cursor position is 
incremented so that the next character will be printed at the following 
screen position. If the last screen position has been reached, the screen 
will be scrolled up one line and the output will continue in the first 
column of the last screen line. 


If bit seven of the BL register is set, the color value will be XORed with 
the previous color value of the pixels. The background color is zero. 


Characters can be displayed in the graphic mode with this function. The 
character patterns are taken from one of the EGA character tables. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 0FH EGA/VGA 
Screen: Returns current display mode 


Reads the number of the current display mode, the number of characters per line, 
and the number of the current display page. 


Input: AH = OFH 
Output: AL= Video mode: 


0: 40x25-character text, 16 colors (EGA/VGA - color monitor) 
1: 40x25-character text, 16 colors (EGA/VGA - color monitor) 


864 


Abacus Appendix E: EGA/IVGA BIOS Functions 


2 80x25-character text, 16 colors (EGA/VGA - color monitor) 
3: 80x25-character text, 16 colors EGA/VGA - color monitor) 
4: 320x200 pixel graphics, 4 colors EGA/VGA - color monitor) 
5: 320x200 pixel graphics, 4 colors (EGA/VGA - color monitor) 
6: 640x200 pixel graphics, 2 colors (EGA/VGA - color monitor) 
af 63 80x25-character text, mono (EGA/VGA - mono monitor) 
13: 320x200 pixel graphics, 16 colors EGA/VGA - color monitor) 
14: 640x200 pixel graphics, 16 colors EGA/VGA - color monitor) 
15: 640x350 pixel graphics, mono (EGA/VGA - mono monitor) 
16: 640x350 pixel graphics, 4 colors (64K EGA - high-resolution 
monitor) 
640x350 pixel graphics, 16 colors (128K EGA/VGA - high- 
resolution monitor) 
17: 640x480 pixel graphics, 2 colors (VGA only) 
18: 640x480 pixel graphics, 16 colors (VGA only) 
19: 320x200 pixel graphics, 256 colors (VGA only) 
AH = Number of characters per line 
BH= Number of current display page 


Remark: The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 00H EGA/VGA 
Screen: Set palette registers 


Sets the contents of a palette register in the attribute controller of the EGA/VGA 
card. 


Input: AH= 10H 
AL= 00H 
BL= Color value 
BH= Register to be addressed 


Output: No output 

Remarks: Since the register number is not checked by the BIOS, you can also 
program the other registers in the attribute controller. These include the 
mode control register, overscan register and others. 


The contents of registers BX, CX, DX, SI, DI, BP, and the segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 01H EGA/VGA 
Screen: Set screen border color 


Copies resulting value into the overscan register of the EGA attribute controller. 


Input: AH= 10H 
AL= 01H 
BH= Border color 
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Output: No output 


Remark: The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 02H EGA/VGA 
Screen: Set all palette registers 


Configures all 16 palette registers and the overscan register. 


Input: AH= 10H 
AL= 02H 
ES = Segment address of color table 
DX = Offset address of color table 


Output: No output 


Remarks: The ES:BX register pair points to a 17-byte table. The first 16 bytes will 
be transferred to the 16 palette registers of the attribute controller and the 
17th byte will be copied into the overscan register. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 03H EGA/VGA 
Screen: Set blinking attribute 


Determines whether bit 7 in the attribute byte of a character in the text mode will 
enable character blinking, or display characters on 2 high-intensity background. 


Input: AH= 10H 
AL= 00H 
BL= Blinking attribute 
BL=0: high-intensity background 


BL=1: blinking 
Output: No output 
Remark: The contents of registers BX, CX, DX, SI, DI, BP and the segment 


registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 07H VGA 
Screen: Read out palette register 


Reads the contents of one of the attribute controller's palette registers. 
Input: AH= 10H 


AL= 07H 
BH= Number of palette register 
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Output: BL= Contents of addressed palette register 


Remarks: Since the BIOS doesn't verify the number of the palette register read, this 
function can read all the registers of the attribute controller. 


The contents of registers BL, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 08H VGA 
Screen: Read contents of overscan register 


Returns the contents of the overscan register containing the screen's border color. 


Input: AH= 10H 
AL= 08H 
Output: BH= Contents of the overscan register 
Remarks: The contents of registers BL, CX, DX, SI, DI, BP and all segment 


registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 09H VGA 
Screen: Read contents of all palette registers and the overscan register 


Copies the contents of the 16 palette registers and overscan register into a buffer. 
Input: AH= 10H 
AL= 09H 
ES = Segment address of the buffer 
DX = Offset address of the buffer 
Output: No output 


Remarks: The buffer must be a minimum of 17 bytes long to allow room for all 
the palette registers (bytes 0-15) plus the overscan register (byte 16). 


The contents of registers BL, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 10H VGA 
Screen: Define a DAC color register 


Allows the definition of one of the 256 available DAC color registers. 


Input: AH= 10H 
BX= Number of the DAC color register (0-255) 
CH = Green value 
CL= Blue value 
DH = Red value 
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Output: No output 

Remarks: Only bits 0 to 5 in the CH, CL and DH registers are of importance to 
this function. All other bits are ignored. 
The contents of registers BL, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 

Interrupt 10H, function 10H, sub-function 12H VGA 


Screen: Load multiple DAC color registers 


Allows the definition of multiple DAC color registers. 


Input: AH= 10H 
AL= 12H | 
BX= Number of the first DAC color register (0-255) 
CX = Number of registers to be loaded 
ES = Segment address of the buffer 
DX = Offset address of the buffer 

Output: No output 

Remarks: The assigned buffer must be able to hold a group of three consecutive 
bytes for each DAC color register. The first byte contains the red value; 
the second byte contains the green value; and the third byte contains the 
blue value. These first three bytes correspond to the first DAC color 
register being accessed, the next three for the bytes to the next DAC color 
register. 
Only bits 0 to 5 in the CH, CL and DH registers are of importance to 
this function. All other bits are ignored. 
If the sum of BX and CX is greater than 255, the first DAC color register 
is reloaded after the last register is loaded. 
The contents of registers BL, CX, DX, SI, DI, BP and all segment 
registers are unchanged by this function. 

Interrupt 10H, function 10H, sub-function 13H VGA 


Screen: Select color register or select a DAC register group 


Manipulates bit 7 of the mode control registers. 


Input: 


Output: 
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AH = 10H 

AL= 13H 

BL= 00H or 01H (see below) 
BH= see below 

No output 
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Remarks: 


This sub-function performs as two different sub-functions, depending on 
the value contained in the BL register. Sub-function 00H allows color 
selection, while sub-function 01H allows the selection of the active DAC 


register group. 


Sub-function 00H copies bit 0 in the BH register into bit 7 of the mode 
control register, thus providing a method of color selection. If bit 0 in the 
BH register contains a value of 0, then the 256 DAC color registers are 
divided into four groups of 64 registers. Color selection involves bits 0-5 
in the corresponding palette register, as well as bits 2-3 of the color select 
register. These eight bits act as the index for the DAC color register. If 
bit 0 in the BH register contains a 1, the DAC color registers are divided 
into 16 groups of 16 registers. Then color selection involves the lowest 4 
bits of the palette register and the lowest 4 bits of the color select 
register, acting as the 8-bit index to the DAC color table. 


Sub-function 01H loads the color select register, whose contents are 
specified by the active group of DAC color registers. The contents of the 
BH register are copied to the color select register. 


The contents of registers BL, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 15H VGA 
Screen: Read a DAC color register 


Returns the contents of one of the 256 DAC color registers. 


Input: 


Output: 


Remarks: 


AH= 10H 
AL= 15H 
BX= Number of the DAC color registers 


CH = Green value 
CL = Blue value 
DH = Red value 


Only bits 0 to 5 in the CH, CL and DH registers are of importance to 
this function. All other bits are ignored. 


The contents of registers BX, DL, SI, DI, BP and all segment registers 
are not affected by this function. 
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Interrupt 10H, function 10H, sub-function 17H VGA 
Screen: Load contents of multiple DAC color registers | 


Loads several DAC color registers at a time. 


Input: AH= 10H 
AL= 17H 
BX= Number of the first DAC color register to be loaded (0-255) 
CX = Number of registers to be loaded 
ES = Segment address of buffer 
DX = Offset address of buffer 


Output: No output 


Remarks: The contents of each DAC color register are represented within a buffer by 
three consecutive bytes. The red value is loaded into the first of these 
registers; the green value is loaded into the second of these registers; and 
the blue value-is loaded into the third register. The first group of three 
bytes corresponds to the first DAC color register addressed, the second 
group to the next DAC color register, etc. 


Only bits 0 to 5 in the CH, CL and DH registers are of importance to 
this function. All other bits are ignored. 


If the sum of BX and CX is greater than 255, the first DAC color register 
is reloaded after the last register is loaded (wrap-around occurs). 


The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 18H VGA 
Screen: Load DAC mask register 


Loads the specified value into the DAC mask register. 

Input: AH= 10H 
AL= 18H 
BL= Value of DAC mask register 

Output: No output 

Remarks: The contents of the DAC mask register play an important role in color 
selection. An AND instruction adds it to the index access to the DAC 
color table. 


The contents of registers BH, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 
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Interrupt 10H, function 10H, sub-function 19H VGA 
Screen: Read out contents of the DAC mask register 


Reads the current contents of the DAC mask register. 


Input: AH= 10H 
AL= 19H 

Output: BL= Contents of the DAC mask register 

Remarks: The contents of the DAC mask register play an important role in color 
selection. An AND instruction adds it to the index access to the DAC 
color table. 


The contents of registers BH, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 1AH VGA 
Screen: Returns method of color selection and color select register 


Returns the method of color selection, contained in the contents of bit 7 of the 
mode control register. It also returns the contents of the color select register chosen 
by the active group of DAC color registers. 


Input: AH= 10H 
AL= 1AH 
Output: BL= Bit 7 of mode control register 


BH= Contents of color select registers 


Remarks: The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 10H, sub-function 1BH VGA 
Screen: Convert DAC color register into gray scales 


Converts a specified range within a DAC color table into gray scales. 
Input: AH= 10H 


BX= Number of first DAC color register to be converted 
CX = Total number of DAC color registers to be converted 


Output: No output 
Remarks: Conversion into grays results from changes to the red, green and blue 


values, as well as the intensity of these values. The default factor for red 
is 0.3, the default factor for green is 0.59, and the default for blue 0.11. 
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The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 00H EGA/VGA 
Screen: Load user-defined character set 


Loads a user-defined character set from RAM into one of the two EGA character 
tables. 


Input: AH= 11H 
AL= 00H 
BH= Limes per character (also bytes per character) 
BL= Character table (0 or 1) 
CX = Number of characters in table 
DX = ASCII code of first character in table 
ES = Segment address of character table in RAM 
BP= Offset address of character table in RAM 


Output: No output 
Remarks: A maximum of 512 characters can be loaded per character table. 


The loaded character set is not activated, nor are the CRTC registers 
programmed to the size of the characters. The changes will not be visible 
on the screen unless the character definitions are loaded into the active 
character table. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 01H EGA/VGA 
Screen: Load 8x14 character set 


Loads the entire 8x14-pixel character set from EGA/VGA ROM-BIOS into one of 


the two character set tables. 
Input: AH= 11H 
AL= 01H 
BL= Character table (0 or 1) 
Output: No output 
Remarks: The loaded character set is not activated, nor are the CRTC registers 


programmed to the size of the characters. The changes will not be visible 
on the screen unless the character definitions are loaded into the active 
character table. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 11H, sub-function 02H EGA/VGA 
Screen: Load 8x8 character set 


Loads the entire 8x8-pixel character set from EGA/VGA ROM-BIOS into one of 


the two character set tables. 
Input: AH= 11H 
AL= 02H 
BL= Character table (0 or 1) 
Output: No output 
Remarks: The loaded character set is not activated, nor are the CRTC registers 


programmed to the size of the characters. The changes will not be visible 
on the screen unless the character definitions are loaded into the active 
character table. The EGA card displays 43 lines on the screen, while the 
VGA card displays 50 lines. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 03H EGA/VGA 
Screen: Activate character set 


Activates one (or two) of the four 256-character character sets. 


Input: AH= 11H 
AL= 03H 
BL= Number of the character set to activate 


Output: No output 


Remarks: Bits zero and one of the BL register specify the number of the character 
set to be accessed when bit three of the attribute byte of the character is 
ZETO. 


Bits two and three of the BL register specify the number of the character 
set to be accessed when bit three of the attribute byte of the character is 
one. 


If the contents of bits zero and one are identical to the contents of bits 
two and three of the BL register, then bit three of the character attribute 
byte has no effect on the character displayed. Only 256 different characters 
can then be displayed on the screen. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 11H, sub-function 04H VGA 
Screen: Load 8x16 character set 


Loads the entire 8x16-pixel character set from the VGA BIOS into one of the two 


character set tables. 
Input: AH= 11H 
AL= 04H 
BL= Corresponding character set table (0 or 1) 
Output: No output 
Remarks: The loaded character set is not activated, nor are the CRTC registers 


programmed to the size of the characters. The changes will not be visible 
on the screen unless the character definitions are loaded into the active 
character table. The VGA card displays 25 text lines on the screen. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 10H EGA/VGA 
Screen: Load and activate user-defined character set 


Loads a user-defined character set from RAM into one of the two EGA character 
tables and activates it by programming the CRTC registers. 


Input: AH= 11H 
AL= 10H 
BH= Lines per character (also bytes per character) 
BL= Character table (0 or 1) 
CX = Number of characters in table 
DX = ASCII code of first character in table 
ES = Segment address of character table in RAM 
BP= Offset address of character table in RAM 


Output: No output 

Remarks: A maximum of 512 characters can be loaded per character table. 
The number of text lines displayed on the screen results from the height 
of the individual characters. It is calculated by dividing the number of 
screen lines (350) by the character height. 


The starting and ending iines of the screen cursor are automatically 
adapted to the height of the new character matrix. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 11H, sub-function 11H EGA/VGA 
Screen: Load and activate 8x14 character set 


Loads the entire 8x14-pixel character set from EGA/VGA ROM-BIOS into one of 
the two character set tables, and activates it by programming the CRTC registers. 


Input: AH= 10H 
AL= 11H 
BL= Character table (0 or 1) 
Output: No output 
Remarks: The function sets the EGA screen to display 25 lines of text, or sets the 


VGA screen to display 28 lines of text. 


The starting and ending lines of the screen cursor are automatically 
adapted to the height of the new character matrix. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 12H EGA/VGA 
Screen: Load and activate 8x8 character set 


Loads the entire 8x8-pixel character set from the ROM-BIOS of the EGA/VGA 
card into one of the two character set tables, and activates it by programming the 
CRTC registers. 


Input: AH= 10H 

AL= 12H 

BL= Character table (0 or 1) 
Output: No output 


Remarks: The function sets the screen to display 43 lines of text (EGA) or 50 lines 
of text (VGA). 


The starting and ending lines of the screen cursor are automatically 
adapted to the height of the new character matrix. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 
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Interrupt 10H, function 11H, sub-function 14H VGA 
Screen: Load 8x16 character set 


Loads a complete 8x16 character set from the VGA card BIOS into one of the two 
character set tables, and activates it through CRTC register programming. 


Input: AH= 10H 
AL= 14H 
BL= Character table (0 or 1) 

Output: No output 

Remarks: When this function is called, the VGA card displays 25 lines of text on 
the screen. 


The starting and ending lines of the screen cursor automatically change to 
match the height of the new character matrix. 


The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 11H, sub-function 30H EGA/VGA 
Screen: Get information about the character generator 


Retums various information about the current status of the character generator. 


Input: AH= 11H 
AL= 03H 
BH= Type of information desired 
BH=0: contents of interrupt vector 1FH 
BH=1: contents of interrupt vector 43:7 
BH=2: address of the ROM 8x14 character table 
BH=3: address of the ROM 8x8 character table 
BH=4: address of the second half of the 8x8 character table 
_ BH=5: address of the alternative ROM 9x14 character table 
BH=6: Address of the alternative ROM 8x16 character table 
BH=7: Address of the alternative ROM 9x16 character table 


Output: CX = Height of current character matrix 
DL= Number of columns per line - 1 
ES = Segment address of the pointer 
BP= Offset address of the pointer 


Remarks: The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers CS, DS and SS are not affected by this function. 
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Interrupt 10H, function 12H, sub-function 10H EGA/VGA 
Screen: Determine EGA/VGA configuration 


Reads the configuration of the EGA/VGA card. 


Input: AH= 12H 
BL= 10H 
Output: BH= Monitor connected 


BH=0: color or high-resolution monitor 
BH=1: monochrome monitor 
BL= EGA/VGA RAM capacity 
BL=0: 64K 
BL=1: 128K 
BL=2: 192K 
BL=3: 256K 


Remarks: The contents of registers DX, SI, DI, BP and the segment registers are 
not affected by this function. 


Interrupt 10H, function 12H, sub-function 20H EGA/VGA 
Screen: Activate alternate hardcopy routine 


Installs an alternative hardcopy routine which prints as many lines as are displayed 
on the screen. The hardcopy routine of the normal ROM-BIOS always prints 25 
lines and is not suited for creating a hardcopy of the EGA/VGA modes, which 
display more than 25 lines on the screen. 


Input: AH= 12H 
BL= 20H 
Output: No output 
Remark: The contents of registers BX, CX, DX, SI, DI, BP and the segment 


registers are not affected by this function. 


Interrupt 10H, function 12H, sub-function 30H EGA/VGA 
Screen: Specify number of scan lines 


Selects the number of scan lines on the screen. 


Input: AH= 12H 
BL= 30H 
AL= Scan line status 
AL=0 : 200 scan lines (EGA and VGA) 
AL=1 : 350.scan lines (EGA and VGA) 
AL=2 : 400 scan lines (VGA only) 


Output: No output 
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The selected number of scan lines can only be displayed when the 


Remarks: 
appropriate video card and monitor are in use. For example, a CGA. 
monitor can only display 200 scan lines, even if the video card can 
operate in a higher resolution. 
The contents of registers BX, CX, DX, SI, DI and BP and all segment 
registers are not affected by this function. 

Interrupt 10H, function 12H, sub-function 31H VGA 


Screen: Toggle palette register loading 


Toggles the automatic loading of palette registers in VGA BIOS. The system 
either loads alternate display modes when function OOH is invoked, or loads default 


values. 


Input: 


Output: 
Remarks: 


AH= 12H 

BL= 31H 

AL= Automatic palette register loading 
AL=0: Yes 
AL=1: No 

No output 


The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 12H, sub-function 32H EGA/VGA 
Screen: Enable/disable CPU access to video RAM 


Enables or disables direct CPU access to video RAM and its different I/O ports. 


Input: 


Output: 
Remarks: 
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AH= 12H 

BL= 32H 

AL= Access status 
AL=0: Access enabled 
AL=1: Access denied 


No output 


The EGA BIOS doesn't recognize this function, but you can still suppress 
video card access directly using bit 1 of the output register (port address 
3C2H). 


The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 
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Interrupt 10H, function 12H, sub-function 33H VGA 
Screen: Enable/disable automatic gray scaling in DAC color registers 


Toggles automatic gray scaling in VGA BIOS. This is different from function 
10H, sub-function 1BH, which enables selective gray scaling in DAC color 
registers. 


Input: AH= 12H 
BL= 33H 
AL= DAC color register gray scaling 
AL=0 : On 
AL=1 : Off 
Output: No output 


_ The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 12H, sub-function 34H VGA 
Screen: Enable/disable text cursor emulation 


Toggles text cursor emulation mode. Calling function 01H (for defining the 
Starting and ending lines of the cursor) doesn't compensate for character matrices in 
different resolutions. This function controls that change when in VGA mode. 


Input: AH= 12H 
BL= 34H 
AL= Cursor emulation mode 
AL=0: On 
AL=1: Off 
Output: No output 


Remarks: The contents of registers BX, CX, DX, SI, DI, BP and all segment 
registers are not affected by this function. 


Interrupt 10H, function 12H, sub-function 36H VGA 
Screen: Suppress screen refresh 


Temporarily suppresses screen refresh. Disabling refresh relieves video RAM of 
many system level tasks, especially those involving complex screen graphics. 


Input: AH= 12H 
BL= 36H 
AL= Screen refresh 
AL=0: On 
AL=1: Off 


Output: No output 
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The contents of registers BX, CX, DX, SI, DI, BP and all segment 


Remarks: 
registers are not affected by this function. 
Interrupt 10H, function 13H | EGA/VGA 


Screen: Display a string 


Displays a string at a specified position on the screen, in a specific display page. 
The characters are taken from a buffer whose address is passed to the function. 


Input: 


Output: 
Remarks: 
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AH= 13H 

AL= Output mode (0-3) 
AL=0: Attribute in BL, reserve cursor position 
AL=1: Attribute in BL, update cursor position 
AL=2: Attributes in buffer, reserve cursor position 
AL=3: Attributes in buffer, update cursor position 

BL= Attribute byte of characters (modes 0 and 1 only) 

CX = Number of characters to be printed 

DH = Screen line 

DL= Screen column 

BH= Video page 

ES = Segment address of the buffer 

BP= Offset address of the buffer 


No output 


In modes 1 and 3 the cursor position is placed after the last character of 
the string so that BIOS output will continue at the character after the 
string. This does not happen in modes 0 and 2. 


In modes 0 and 1 the buffer contains only the ASCII codes of the 
characters to be printed. The color of all of the characters in the string is 
specified by the BL register. In modes 2 and 3, each character in the buffer 
is followed by the corresponding attribute byte, so that each character has 
its Own attribute. The BL register does not have to be loaded in these 
modes. Although the string must be twice as long as the number of 
characters to be printed in these modes, the CX register contains just the 
number of ASCII characters to be printed, not the string buffer's length. 


Control codes such as bell and carriage return are interpreted as control 
codes and not as normal ASCII codes. An error occurs when carriage 
retum and linefeed are printed on a display page other than zero, however. 
These characters may be printed on display page 0, regardless of the 
display page specified in BH. 


When the last screen position i- reached the screen will move up one line 
and the output will continue with the first column of the last screen line. 


When printing in the graphic mode the contents of the BL register 
determine the foreground color of the character (the background is zero). If 
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bit seven of the BL register is set, the color value will be XORed with 
the old color value. 


This function can also be used to print characters in the graphic mode, in 
which case the character patterns will be taken from one of the EGA/VGA 
character tables. 


The contents of registers BX, CX, DX, SI, DI, BP and the segment 
registers are not affected by this function. 


Interrupt 10H, function 1AH VGA 
Screen: Determine video card type 


Input: 


Output: 


Remarks: 


Determines the existence of the active video card. 


AH= 13H 
AL= 0 
AL= 1AH 


BL= Device code for active video card 
BH= Device code for inactive video card 


If the value 1AH is not loaded into the AL register, then the video card in 
operation is not a VGA card (the 1AH indicates a VGA BIOS). The 
function can return the following device codes: 


FFH = Unknown video card 

OOH = No video card 

01H = MDA with monochrome display 

02H = CGA with CGA monitor 

04H = EGA with EGA or multisync monitor 

05H = EGA - monochrome display 

07H = VGA - analog monochrome display 

08H = VGA - analog color display (VGA, multisync) 


The contents of registers CX, DX, SI, DI, BP and all segment registers 
are not affected by this function. 
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Interrupt 33H, function 00H Mouse 
Reset mouse driver 


Resets (initializes) the mouse driver. 
Input: AX = Q00Q00H 
Output: AX = Mouse installation status 
AX=FFFFH: Mouse driver installed 
AX=QO000H: Error, no mouse driver installed 
BX= Number of mouse buttons 
Remarks: The reset process executes the following tasks: 


Moves the mouse pointer to the center of the screen and clears the pointer 
from the screen. When enabled, the default pointer appears as an inverse 
video square. The representation is always in display page 0, independent 
of the current display mode. The entire screen area becomes the total range 
of mouse movement. 


Installs the event handler is installed by a program (default is disabled). 
Installs lightpen emulation (default is disabled). 


Specifies mouse pointer's speed. Default relative speed is 8 mickeys per 8 
horizontal pixels and 16 mickeys per 16 vertical pixels. 


Specifies maximum mouse speed (default is 64 mickeys per second). 


882 


Abacus Appendix F: Mouse Driver Interrupts 


Interrupt 33H, function 01H Mouse 
Display mouse pointer 


Displays the mouse pointer on the screen. This pointer follows any movement the 
user makes with the mouse device. 


Input AX = Q001H 
Output: No output 
Remarks: This function increments an internal counter which determines whether 


the mouse pointer should be displayed on the screen. When the mouse 
driver is initialized using function 00H, this pointer contains the value -1 
(i.e., the mouse pointer does not appear). If this counter contains the 
value 0 after calling function 01H, the mouse pointer appears on the 
screen. 


The mouse driver follows the mouse movement even when the mouse 
pointer is not displayed on the screen. After calling this function, the 
mouse pointer may not appear at the same location as it was when the 
pointer was previously removed by calling function 00H or function 02H. 


Interrupt 33H, function 02H Mouse 
Remove mouse pointer 


Removes the mouse pointer from the screen. 


Input AX = 0002H 
Output: No output 
Remarks: This function decrements an internal counter which determines whether 


the mouse pointer should appear on the screen. If the counter contains the 
value 0, the mouse pointer is displayed on the screen, while the value -1 
removes the mouse pointer from the screen. 


The mouse driver follows the mouse movement even when the mouse 
pointer is not displayed on the screen. 


After calling this function, the mouse pointer may not appear at the same 


location as it was when the pointer was previously removed by calling 
function OOH or function 02H. 
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Interrupt 33H, function 03H Mouse 
Get pointer position/button status 


Returns the current position of the mouse pointer and the current status of the 
mouse buttons. 


Input AX = 0003H 


Output BX= Mouse button status 
Bit 0=1: Left mouse button activated 
Bit 1=1: Right mouse button activated 
Bit 2=1: Center mouse button activated 
Bits 3-15: Unused 
CX = X coordinate (horizontal mouse position) 
DX = Y coordinate (vertical mouse position) 


Remarks: The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


If the mouse is equipped with only two mouse buttons, the information 
about the central mouse button does not have significance. 


Interrupt 33H, function 04H Mouse 
Move mouse pointer 


Moves the active mouse pointer to a certain position on the screen. 


Input AX= 0004H 
CX = X coordinate (horizontal mouse position) 
DX = Y coordinate (vertical mouse position) 


Output: No output 


Remarks: The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


If the position indicated is outside the range of movement specified by 
functions 07H and 08H, the function adjusts coordinates so that the 
mouse pointer remains within this range of movement. 


The mouse pointer moves to the new position, even if the mouse is not 
currently visible. Once re-enabled, the mouse pointer appears at this new 
position. 
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Interrupt 33H, function 05H Mouse 
Determine number of times mouse button was activated 


Informs the calling program of how often a mouse button has been pressed since 
the last call of function OSH. Function 05H also informs the calling program of 
the pointer's location on the screen when the button was last activated. 


Input AX = 0005H 
BX= Mouse button activated 
BX=0: Left mouse button 
BX=1: Right mouse button 
BX=2: Center mouse button 


Output: BX= Status of all mouse buttons: 
Bit 0=1: Left mouse button activated 
Bit 1=1: Right mouse button activated 
Bit 2=1: Center mouse button activated 
Bits 3-15: Unused 
BX= Mouse buttons activated since last function call 
CX = Horizontal mouse position during the last activation 
DX = Vertical mouse position during the last activation 


Remarks: The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. The activation counter for the 
mouse button addressed is reset to 0 when this function is called. 


Interrupt 33H, function 06H Mouse 
Determine number of times mouse button was released 


Informs the calling program of how often a mouse button has been released since 
the last call of function 06H. Function 06H also informs the calling program of 
the pointer's location on the screen when the button was last activated. 


Input AX = 0006H 
BX= mouse button addressed 
BX=0: Left mouse button 
BX=1: Right mouse button 
BX=2: Center mouse button 


Output: BX= Status of all mouse buttons 
Bit 0=1: Left mouse button activated 
Bit 1=1: Right mouse button activated 
Bit 2=1: Center mouse button activated 
Bits 3-15: Unused 
BX= Mouse buttons activated since last function call 
CX = Horizontal mouse position during the last activation 
DX = Vertical mouse position during the last activation 
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Remarks: The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


The activation counter for the mouse button addressed is reset to 0 when 
this function is called. 


Interrupt 33H, function 07H Mouse 
Set horizontal range of movement 


Defines the horizontal range of movement for the mouse pointer. Once set, the 
user cannot move the mouse pointer out of this range. 


Input AX = 0007H 
CX = Minimal horizontal pointer position 
DX = Maximum horizontal pointer position 


Output: No output 


Remarks: The coordinates passed in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


If the mouse pointer is outside of this range when function 07H is called, 
the mouse driver automatically moves the mouse pointer within the 
limits of the range of movement. If the value in the DX register is less 
than the value in the CX registers, the two parameters are exchanged. 


Interrupt 33H, function 08H Mouse 
Set vertical range of movement 


Defines the vertical range of movement for the mouse pointer. Once set, the user 
cannot move the mouse pointer out of this range. 


Input AX = 0008H 
CX = Minimum vertical pointer position 
DX = Maximum vertical pointer position 


Output: No output 

Remarks: The coordinates passed in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


If the mouse pointer is outside of this range when function 07H is called, 
the mouse driver automatically moves the mouse pointer within the 
limits of the range of movement. 
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If the value in the DX register is less than the value in the CX registers, 
the two parameters are exchanged. 


Interrupt 33H, function 09H Mouse 
Set mouse pointer (graphic mode) 


Defines the appearance of the mouse pointer in graphic mode, as well as the 
bitfield which compensates for the pixels around the mouse pointer. 


Input AX= 0009H 
BX= Pointer width starting at left border of bitfield 
CX = Pointer height starting at top border of bitfield 
ES = Segment address of bitfield 
DX = Offset address of bitfield 


Output: No output 


Remarks: The bitfield consists of 64 bytes, of which the first 32 are an AND 
comparison, and the remaining 32 are an OR combination. Both sets of 
bytes are based upon the current pixel pattern. 


Interrupt 33H, function 0AH Mouse 
Set mouse pointer (text mode) 


Defines the bitmask which specifies the appearance of the mouse pointer in text 
mode. 


Input AX = Q000AH 
BX= Pointer type 
BX=0: Software pointer 
BX=1: Hardware pointer 
CX = AND mask (software pointer) or starting line (hardware pointer) 
DX = XOR mask (software pointer) or ending line (hardware pointer) 


Output: No output 


Remarks: If the software pointer is selected, the code of the character beneath the 
mouse pointer and its attribute byte are combined logically with the mask 
in the CX register through a binary AND, and then with the value in the 
DX register through an exclusive OR (XOR). The attribute byte is 
combined with the most significant byte (CH and DH). The character code 
is combined with the least significant byte (CL and DL). 


The hardware pointer is the same shape as the normal text mode cursor. 
Monochrome mode values for the starting and ending lines range from 0 
to 13. Color mode values for the starting and ending lines range from 0 to 
7. 
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Interrupt 33H, function 0BH Mouse 
Determine movement values 


Determines the distance between the current mouse position and the mouse 
position during the last call of function OBH. 


Input AX = 00OOBH 


Output: CX = Horizontal distance from last point in mickeys 
DX = Vertical distance from last point in mickeys 


Remarks: These values must be interpreted as signed numbers. Positive values 
indicate movement toward the bottom or right border of the screen, while 
negative values indicate movement toward the top or left border of the 
screen. 


These values are given in mickeys.(1 mickey=1/200 inch) rather than in 
pixels. 


Interrupt 33H, function 0CH Mouse 
Set event handler 


Sets the address of an event handler called by the mouse driver when a particular 
mouse event occurs. 


Input AX = QOOCH 
CX = Events which trigger the call of the event handler (event mask) 
Bit 0: Mouse movement 
Bit 1: Left mouse button activated 
Bit 2: Left mouse button released 
Bit 3: Right mouse button activated 
Bit 4: Right mouse button released 
Bit 5: Center mouse button activated 
Bit 6: Center mouse button released 
Bits 7-15: Unused 
ES = Segment address of handler 
DX = Offset address of handler 


Output: No output 


Remarks: The event handler is called by the mouse driver through a FAR cail 
assembler instruction, and therefore must be terminated with a FAR RET 
instruction. None of the various processor registers may be returned to the 
caller with a changed content. 


The mouse driver passes the following information to the event handler 
through the processor registers during the call: 


AX = event mask. The bits correspond to the various events as indicated 
in the CX register during the installation of the event handler. In 
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addition, other bits can be set, since the value reflects the current 
status of the mouse driver, and is not limited to the selected events. 


BX= mouse button status: 

Bit 0 = Left mouse button activated 

Bit 1 = Right mouse button activated 

Bit 2 = Center mouse button activated 
CX = horizontal mouse position. 
DX = vertical mouse position. 
SI= length of last horizontal mouse movement. 
DI= length of the last vertical mouse movement. 


DS = data segment of the mouse driver. 


The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


The values in the SI and DI registers refer to mickeys (one mickey = 
1/200 inch). 


These mickey values must be interpreted as signed numbers. Positive 
values indicate movement toward the bottom or right border of the screen, 
while negative values indicate movement toward the top or left border of 
the screen. 


Interrupt 33H, function 0DH Mouse 
Enable lightpen emulation 


Enables emulation of the lightpen, and simulates a lightpen which if none is 


present. 
Input AX = 0QOODH 
Output: No output 
Remarks: Lightpen emulation only makes sense when used with an application 


which supports the lightpen, or makes lightpen reading routines available 
(e.g., the PEN command in PC-BASIC). 


The lightpen and mouse are closely related in programming: The position 
of the mouse pointer is directly related to the lightpen's position on the 
screen, and pressing the left and right mouse button has the same result as 
pressing the button on the lightpen. 
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Interrupt 33H, function 0OEH Mouse 
Disable lightpen emulation 


Disables the lightpen emulation enabled by a previous call to function ODH. 


Input AX = QQOEH 
Output: No output 
Remarks: Lightpen emulation only makes sense when used with an application 


which supports the lightpen, or makes lightpen reading routines available 
(e.g., the PEN command in PC-BASIC). 


The lightpen and mouse are closely related in programming: The position 
of the mouse pointer is directly related to the lightpen's position on the 
screen, and pressing the left and right mouse button has the same result as 
pressing the button on the lightpen. 


Interrupt 33H, function 0FH Mouse 
Set pointer speed 


Defines the relationship between mickeys and screen pixels. This specifies. the 
sensitivity of the mouse and the speed at which the mouse pointer moves across 
the screen. | 


Input AX = OOOFH 
CX = Number of horizontal mickeys 
DX = Number of vertical mickeys 
Output: No output 
Remarks: Values in the CX and DX registers can range from 1 to 32767. 


The default setting is 8 horizontal mickeys and 16 vertical mickeys. This 
causes the mouse pointer to move twice as fast horizontally as it moves 
vertically. 


Cailing function OOH (Reset mouse driver) changes any previously set 
values to the default values. 
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Interrupt 33H, function 10H Mouse 
Exclusion area 


Designates any area of the screen as an exclusion area. The mouse pointer 
disappears if moved into the exclusion area. 


Input AX = 0010H 
CX = X-coordinate, upper left corner of exclusion area 
DX = Y-coordinate, upper left corner of exclusion area 
SI= X-coordinate, lower right comer of exclusion area 
DI= Y-coordinate, lower right corner of exclusion area 


Output: No output 


Remarks: The coordinates passed in the CX, DX, DI and SI registers refer to the 
pixel positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


Calling function OOH (Reset mouse driver) or function 01H (Display 
mouse pointer) deletes the exclusion area coordinates. 


Interrupt 33H, function 13H Mouse 
Set maximum for mouse speed doubling 


Sets the maximum limit for doubling mouse speed. If the speed of the mouse 
movement exceeds a certain limit, the mouse driver doubles the mouse pointer 
speed by doubling the movement's relationship between points and mickeys. 


Input AX = 0013H 

DX = Limit in mickeys per second 
Output: No output 
Remarks: 1 mickey=1/200 inches. 


To prevent doubling of the mouse speed, the limit can be set higher. 


Speeds in excess of 5,000 mickeys per second cannot be achieved by 
practical means. 
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Interrupt 33H, function 14H Mouse 
Exchange event handlers 


Installs a new event handler for certain mouse events, but also retains the address 
of the old event handler. 


Input AX= 0014H 
CX = Events which should trigger event pane call 
Bit 0: Mouse movement 
Bit 1: Left mouse button activated 
Bit 2: Left mouse button released 
Bit 3: Right mouse button activated 
Bit 4: Right mouse button released 
Bit 5: Center mouse button activated 
Bit 6: Center mouse button released 
Bit 7-15: Unused 


ES = Segment address of new event handler 
DX = Offset address of new event handler 


Output: CX = Event mask of the previously installed event handler 
ES = Segment address of previously installed event handler 
DX = Offset address of previously installed event handler 


Remarks: The event handler is called by the mouse driver through a FAR call 
assembler instruction, and therefore must be terminated with a FAR RET 
instruction. None of the various processor registers may be returned to the 
caller with a changed content. 


The mouse driver passes the following information to the event handler 
through the processor registers during the call: 


AX = event mask. The bits correspond to the various events as indicated 
in the CX register during the installation of the event handler. In 
addition, other bits can be set, since the value reflects the current 
status of the mouse driver, and is not limited to the selected events. 


BX= mouse button status: 
Bit O = Left mouse button activated 


Bit 1 = Right mouse button activated 
Bit 2 = Center mouse button activated 
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CX = horizontal mouse position. 

DX = vertical mouse position. 

SI= length of last horizontal mouse movement. 
DI= length of the last vertical mouse movement. 
DS = data segment of the mouse driver. 


The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


The values in the SI and DI registers refer to mickeys (one mickey = 
1/200 inch). 


These mickey values must be interpreted as signed numbers. Positive 
values indicate movement toward the bottom or right border of the screen, 
while negative values indicate movement toward the top or left border of 
the screen. 


Interrupt 33H, function 15H Mouse 
Determine mouse status buffer size 


Returns the size of the mouse status buffer, in which a program can store the 
complete status of the mouse driver. 


Input AX = 0015H 

Output: . BX= Mouse status buffer size in bytes 

Remarks: Function 16H (Store mouse status) stores the mouse status in the buffer. 
Interrupt 33H, function 16H Mouse 


Store mouse status 


Stores mouse status information in a buffer. 


Input AX = 0016H 
ES = Segment address of mouse status buffer 
DX = Offset address of mouse status buffer 


Output: No output 
Remarks: The caller is responsible for creating a buffer large enough to contain all 
the status information. Before calling this function, call function 15H 


(Determine mouse status buffer size) to determine the size of the mouse 
Status buffer. 
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This function works well when called before executing a program using 
the EXEC function. This allows the mouse status to be saved in 
memory, then restored from within the called program. 


Interrupt 33H, function 17H Mouse 
Restore mouse status 


Reads all mouse parameters from a buffer where they had been stored by function 


16H. 
Input AX= 0017H 
ES = Segment address of mouse status buffer 
DX = Offset address of mouse status buffer 
Output: No output 
Interrupt 33H, function 18H Mouse 


Install alternate event handler 


This function permits a program to install a limited range event handler. This 
handler can be called by the mouse driver when certain mouse events occur in 
conjunction with the keyboard. 


Input AX = 0018H 
CX = Events which should trigger the call of the event handler 
Bit 0: Mouse movement | 
Bit 1: Left mouse button activated 
Bit 2: Left mouse button released 
Bit 3: Right mouse button activated 
Bit 4: Right mouse button released 
Bit 5: Shift key pressed during mouse button event 
Bit 6: Ctrl key pressed during mouse button event 
Bit 7: Alt key pressed during mouse button event 
Bits 8-15: Unused 
ES = Segment address of event handler 
DX = Offset address of event handler 


Output: AX = Installation status 
AX=0018H: Event handler installed 
AX=FFFFH: Event handler could not be installed 


Remarks: At least one of bits 5 to 7 must be set in the event mask of the CX 
register to ensure that the event reacts to at least one of the control keys. 
If the programmer prefers not to read the Shift, Ctrl or Alt keys along 
with mouse buttons, use functions OCH or 14H instead. 


An error can occur if three alternate event handlers were previously 
installed, or if an event handler with the same event mask already exists. 
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The event handler is called by the mouse driver through a FAR call 
assembler instruction, and therefore must be terminated with a FAR RET 
instruction. None of the various processor registers may be returned to the 
caller with a changed content. 


The mouse driver passes the following information to the event handler 
through the processor registers during the call: 


AX = event mask. The bits correspond to the various events as indicated 
in the CX register during the installation of the event handler. In 
addition, other bits can be set, since the value reflects the current 
status of the mouse driver, and is not limited to the selected events. 


BX= mouse button status: 

Bit O = Left mouse button activated 

Bit 1 = Right mouse button activated 

Bit 2 = Center mouse button activated 
CX = horizontal mouse position. 
DX = vertical mouse position. 
SI = length of last horizontal mouse movement. 
DI= length of the last vertical mouse movement. 


DS = data segment of the mouse driver. 


The coordinates returned in the CX and DX registers refer to the pixel 
positions in the virtual mouse display screen rather than physical 
positions on the actual display screen. 


The values in the SI and DI registers refer to mickeys (one mickey = 
1/200 inch). 


These mickey values must be interpreted as signed numbers. Positive 
values indicate movement toward the bottom or right border of the screen, 
while negative values indicate movement toward the top or left border of 
the screen. 
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Interrupt 33H, function 19H Mouse 
Determine address of alternate event handler 


Returns the address of an alternate event handler to the caller. 


Input AX = 0019H 
CX = Event handler event mask 


Output: CX = OOOOH: Error 
ES = Segment address of event handler 
DX = Offset address of event handler 


Remarks: See the description of function 18H above for additional information 
about the meanings of each bit in the event mask. 


The function call fails if no alternate event handler with the indicated 
event mask was previously installed. 


Interrupt 33H, function 1AH Mouse 
Set mouse sensitivity 


Defines the relationship between physical mouse movement and mouse pointer 
movement. Also defines the maximum for doubling mouse speed. 


Input AX = 001AH 
BX= Number of horizontal mickeys 


CX = Number of vertical mickeys 
DX = Maximum limit for doubling the mouse speed 


Output: No output 
Remarks: Values in the CX and DX registers can range from 1 to 32767. 


The default setting is 8 horizontal mickeys and 16 vertical mickeys. This 
causes the mouse pointer to move twice as fast horizontally as it moves 
vertically. 

To prevent doubling of the mouse speed, the limit can be set higher. 


Speeds in excess of 5,000 mickeys per second cannot be achieved by 
practical means. 


Calling function OOH (Reset mouse driver) changes any previously set 
values to the default values. 
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Interrupt 33H, function 1BH Mouse 
Determine mouse sensitivity 


Returns the parameters previously set by calling function 1AH or functions OFH 
and 13H. 


Input AX= 001BH 


Output: BX= Number of horizontal mickeys 
CX = Number of vertical mickeys 
DX = Maximum limit for doubling the mouse speed 


Interrupt 33H, function 1CH Mouse 
Set mouse hardware interrupt rate 


Determines the frequency at which the mouse hardware reads the current mouse 
position and mouse button status. 


Input AX= 001CH 
BX= Interrupt rate 
Bit 0: No interrupts 
Bit 1: 30 interrupts per second 
Bit 2: 50 interrupts per second 
Bit 3: 100 interrupts per second 
Bit 4: 200 interrupts per second 
Bits 5-15: Unused 


Output: No output 
Remarks: This function is only available for the Inport mouse. 


If more than one bit is set in the BX register, only the least significant 
bit which is set counts. 


The mouse's resolution increases with the number of interrupts. The 
increased number of mouse interrupts decreases the speed of the 


foreground program. 


Interrupt 33H, function 1DH Mouse 
Set display page 


Specifies the display page on which the mouse pointer appears. 


Input AX = 001DH 

BX= Number of the display page 
Output: No output 
Remarks: Default value is display page 0. 
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Calling this function only makes sense if the application program works 
with several display pages, as available on CGA, EGA and VGA cards. 


Interrupt 33H, function 1EH Mouse 
Determine display page 


Determines the display page on which the mouse pointer appears. 


Input AX= 001EH 
Output: BX= Number of the display page 
Interrupt 33H, function IFH Mouse 


Deactivate mouse driver 


Deactivates the current mouse driver and returns the address of the previous 
interrupt handlers for interrupt 33H. 


Input AX = 001FH 

Output: AX = Error status 
AX=FFFFH: Error 
AX=001FH: O.K. 


ES = Segment address of previous event handler 
BX= Offset address of previous event handler 


Remarks: This call releases any previously installed and active mouse driver 
interrupt routines. The exception to this is the handler for interrupt 33H, 


but the caller can reload this interrupt vector with its original value since 
this address is returned in the ES:BX register pair. 


Interrupt 33H, function 20H Mouse 
Activate mouse driver 


Activates a mouse driver previously deactivated by function 1FH. 
Input AX = 0020H 


Output: No output 


898 


Abacus Appendix F: Mouse Driver Interrupts 


Interrupt 33H, function 21H Mouse 
Reset mouse driver 


Resets the mouse driver, disables the mouse pointer and disables the currently 
installed event handler. 


Input AX = 0021H 


Output: AX = Error status 
AX=FFFFH: Error 
AX=0021H: O.K. 
BX= Number of mouse buttons 


Remarks: Unlike function OOH, this function does not perform a total mouse 
hardware reset. 


Interrupt 33H, function 24H Mouse 
Determine mouse type 


Determines the type of mouse installed and the version number of the mouse 
driver. 


Input AX = 0024H 


Output: BH= Whole number of the version number 
BL= Fraction of the version number 
CH= Mouse type 
CH=1: Bus mouse 
CH=2: Serial mouse 
CH=3: Inport mouse 
CH=4: PS/2 mouse 
CH=5: HP mouse 
CL = IRQ number 
CL=0: PS/2 
CL=2, 3, 4, 5 or 7: IRQ number in the PC 


Remarks: If the version number of the mouse driver is for example 6.24, the value 


6 is returned in the BH register and the value 24 is returned in the BL 
register. 
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Introduction to Number 
Systems 


Throughout this book we talked about numbers notated in the binary and 
hexadecimal systems instead of the normal decimal system. This Appendix 
presents a brief introduction to these number systems. 


Decimal system 


Before explaining the new number systems, you should know the basic concepts 
of the decimal system. The decimal number 1989 can also be written as 
1* 1000+9* 100+8* 10+9*1. This shows that if you number the digits from right 
to left, the first number represents a column of ones, the second number represents 
a column of tens, the third number represents a column of hundreds and the fourth 
number represents a column of thousands. The numbers increase from right to left 
in powers of 10. 


The first digit of any number system has the value 1. The factor by which the 
value increases from one column to the next differs among the number systems. 
This factor corresponds to the numbers with which the number system works. The 
factor is 10 with the decimal system because ten different numbers are available for 
each digit (0 to 9). 


This principle of powers for each column also applies to the binary and 
hexadecimal systems. 


Binary system 


Since a computer recognizes the numbers 0 and 1 on its lowest functional level, 
the binary system is essential to computing. The value of the numbers double 
from column to column because the binary system only uses powers of two for 
each column (i.e., the numbers 0 and 1 instead of the numbers 0 to 9). 
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Now let's count the binary places starting from right to left as we did in the 
decimal example described above. The first (right hand) position counts as one, the 
second as two, the third as four and the fourth as eight. The places then follow as 
16, 32, 64, 128, etc. 


For example, 11001 binary converts to 25 decimal, or the equation 
1* 16+1*8+0*4+0*2+1*1. 


Hexadecimal system 


Unlike the binary system, the hexadecimal system operates with more basic 
numbers than the decimal system. This system counts single digits from 0 to F. 
Since only the ten numbers of the decimal system are able to represent a number, 
the numbers from 10 to 15 in hexadecimal use the letters A to F in addition to the 
numbers 0 to 9. AH stands for 10, BH for 11, CH for 12, DH for 13, EH for 14 
and FH for 15. 


By using 16 numbers or letters for each position, the value by which each position 
increments is 16. 


The first position has the value 1, the second 16, the third 256 and the fourth 
4,096. 


For example, the hexadecimal number FB3H converts into 4,019 decimal, or 
15*256+11*16+3* 1. 


Hex and binary 


The hexadecimal system and the binary system are easily converted back and forth. 
For example, one four-digit binary number converts to a single-digit hexadecimal 
number. Because of this, the hexadecimal system is an important part of assembly 
language programming. It's much simpler to convey a byte (an eight-bit number) 
using two hexadecimal digits than it is for the developer to compute a 16-bit 
binary equivalent. 


This book denotes all binary numbers by the letter (b), and all hexadecimal 
numbers by the letter H. 


The following illustrations should help explain number systems more clearly. 
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Hexadecimal | 65536 | 4096 | 256 


Number positions in each number system 


Decimal Binar Hexadecimal 

0 (b) | OH 

1 (b) 1H 

10 (b) 2H 

11 (b) 3H 

100 (b) 4H 

101 (b) 5H 

110 (b) 6H 

111 (b) 7H 

1000 (b) 8H 

1001 (b) OH 

1010 (b) AH 

1011 (b) BH 

1100 (b) CH 
10000000 (b) 
10000001 (b) 
100000000 (b) 
10000000000 (b) 
1000000000000 (b) 
65535 1111111111111111 (b) 


Bw ND ODP W DN eH © 


Comparing selected numbers in each number system 
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$086, 8088, 80186, 80286, 80386 


Microprocessors manufactured by the Intel Corporation. They are upwardly 
compatible, which means that the 80836 can execute any program developed for an 
8086, 8088, 80186 or 80286 microprocessor. However, the 8088 can't always 
execute an application developed for one of the later microprocessors. The 
processors of this family act as main processors for different types of PCs. 


Address 


The Intel-80xx family of microprocessors form an address from one of the four 
segment registers, in conjunction with another register or a constant. The contents 
of the segment register becomes the segment address, and the other register or 
constant becomes the offset address. Both addresses are logical addresses that are 
related to a physical address (the actual number of a memory location). This 
physical address can be determined by multiplying the segment register by 16 and 
adding the offset address. 


Address area 


The number of memory locations addressable by a microprocessor. 


Address bus 


A line connecting the CPU with memory (RAM and ROM). If the CPU wants to 
address a memory location, it must first place its address on the address bus in 
order to set the "switches" for access to this memory location. 


Arena header 


The data structure which precedes the memory area of the TPA assigned to a 
program. DOS uses this area to store the memory area's size and other 
information. 
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ASCII 


Abbreviation for American Standard Code for Information Interchange. 
ASCII is a standardized assignment of numbers from 0 to 255 that represents 
characters (e.g., letters, numbers). The ASCII codes from 0 to 127 comprise the 
standard ASCII character set, while the codes from 128 to 255 comprise the 
extended ASCII character set. 


Assembly language 


A small number of simple instructions that the processor can understand. Every 
higher level language program is finally translated into these instructions for 
processing by the CPU. 


Asynchronous data transfer 


Also known as serial transfer. Bytes are transmitted and/or received bit by bit 
according to a predetermined transfer protocol. 


AT 
Abbreviation for Advanced Technology. AT computers have an 80286 
processor. 

Attribute 
A byte following each character that defines the character's color and appearance for 
display on the screen. 

AUTOEXEC.BAT 


Filename for the automatically executing batch file for which DOS searches during 
the booting process. After DOS is loaded and started, it searches the root directory 
of the device from which it booted for a file named AUTOEXEC.BAT. During the 
booting process, this batch file executes programs and parameters through the 
command processor. 


Batch files 


Text files saved with the file extension .BAT. These files contain DOS commands 
or command sequences. Batch file execution treats these commands as if the user 
had entered the commands from the keyboard. 


Baud 


A measurement of data transfer speed. One baud roughly equals one data bit per 
second. 


BCD 


Abbreviation for Binary Coded Decimal. This number represents a two-digit 
decimal number encoded in one byte. The upper four bits represent the most 
significant digit and the lower four bits represent the least significant digit. 


904 


Abacus Appendix H: Glossary of Terms 


Binary system 


The number system understandable by a computer at its lowest level. Binary 
notation counts from 0 to 1. The first position of a binary number has the value 1, 
the second has the value 2, the third has the value 4, the fourth has the value 8, 
etc. 


BIOS 


Abbreviation for Basic Input/Output System. It contains the device drivers 
which perform access to the peripheral devices such as the keyboard, monitor, disk 
drives, etc. The BIOS is located in addresses FOO0:EQOO—F000:FFFF. 


BIOS interrupts 
Interrupts 10H to 17H and interrupt 1AH, through which the many functions of 
the ROM-BIOS can be called. 

BIOS version 
Release date of the BIOS as stored in the eight bytes starting at memory location 
FO00:FFF5. This version appears in the form Month/Day/Year. 

Block driver 


The device drivers which control access to devices that process data in data blocks 
(disk drives and hard disks). Block drivers are addressed through a letter (drive 
specifier) which enables one block driver to control several devices with different 
letters. The disk driver has the drive specifiers A: and B:, while the hard disk driver 
can be addressed with the specifier C:. 


Boot sector 


Contained on every mass storage medium from which DOS can be booted. Sector 
0 contains certain information and a short program which loads a DOS boot 
routine, then initializes DOS. 


Booting 


The process that starts after the user has switched on the computer. BIOS tests and 
initializes the various circuit chips in the system, then loads the operating system. 


BPB 
Abbreviation for BIOS Parameter Block. The BPB defines the format and 
design of a mass storage device (disk drive and hard disk) for DOS. It is available 
in the boot sector of every mass storage device, but must be passed to DOS by the 
initialization routine of a block device driver. 

CALL 


Assembly language instruction that triggers the execution of a subroutine. After 
the routine ends, a RET instruction executes, which is followed by the instruction 
following the initial CALL. 
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Carry flag 


Bit 0 in the processor's flag register. Many operating system functions use it to 
tell the calling program whether the called function executed correctly, or if an 
error occurred. In the latter case, the carry flag is set (1) after the function call. 


Character driver 


A device driver which controls access to devices that process characters as bytes. 
The screen, keyboard and printer are device drivers. Character drivers have their own 
names, such as CON, PRN and AUX. 


Child program 


A program which is called by another program. For example, if the FORMAT 
command is called from the DOS level, the parent program is the command 
processor. 


CLI 


Clear interrupts instruction. This instruction instructs the CPU to ignore all 
subsequent interrupt requests until the STI (STart Interrupts) instruction re-enables 
interrupt response (the NMI [Non-Maskable Interrupt] is exempt from this 
instruction). 

Clock driver 


A character device responsible for getting the time and date from DOS, 
incrementing the time and date and passing the incremented amounts back to DOS. 


Clock generator 


Produces several million pulses per second and synchronizes various components 
of the system with each other. 


Cluster 


Multiple sectors of a mass storage device. Files and subdirectories can be stored in 
different clusters. The number of sectors per cluster varies from one device to 
another. 


COM files 


Executable programs which must be stored within a 64K memory segment. COM 
files combine program code, data and stack in this 64K area. 


COMMAND.COM 
The file containing the MS-DOS command processor. 


Command line 


A line from which program or batch file calls can be entered into the command 
processor. 
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Command parameters 


The name for all characters passed in the command line, following the program or 
batch file calls. The EXEC function copies these parameters into the PSP of the 


loaded program. 
Command processor 


Also called shell. The command processor is a part of the operating system which 
accepts and processes user input. Its main function is to load and start application 


programs and batch files. 

CON 
Abbreviation for CONsole driver, the two device drivers which control the 
keyboard and the screen. 

CONFIG.SYS 


The DOS configuration file. It contains certain commands for configuring DOS, as 
well as additional device drivers. CONFIG.SYS loads and executes only once 
(during the booting process). 


Control characters 


ASCII characters which represent certain non-alphanumeric characters. This applies 
to all ASCII codes less than 32. The PC only uses ASCII codes 0, 7, 8, 9, 10, 11, 
12 and 13 as control characters. 


Cooked mode 


Character mode that checks for certain unusual characters, which are either 
converted to other characters or completely filtered out. Character drivers operate 
either in raw mode or cooked mode. 


CP/M-80 


Early operating system, the predecessor of MS-DOS. CP/M is used by computers 
that are based upon Z-80 microprocessors. 


CPU 


Abbreviation for Centrai Processing Unit. The microprocessor which forms 
the "brain" of a computer. 


CRC 


Abbreviation for Cyclical Redundancy Check. The CRC tests for errors 
during data transfer to and from a disk. 
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CRT a 
Abbreviation for Cathode Ray Tube. A CRT generates a screen display with 
the help of an electron beam which sends electrical impulses to a glass screen at 
the end of the CRT. 

DASD 
Abbreviation for Direct Access Storage Device. In DOS and BIOS 
terminology this concept is used for disk drives and hard disks. 

Data bus 


A data line which connects the CPU with memory (RAM and ROM). Data can be 
transmitted between the CPU and memory over this line. 
Device driver 


Driver systems which interface DOS and hardware by making basic functions 
available for communicating with the hardware. Device driver functions can be 
called by the higher level DOS functions. DOS differentiates between character 
drivers and block drivers. 

Disks | 
Flat plastic materials containing magnetic media for storing data. Formatted disks 
are partitioned into tracks and sectors. 

Disk controller | 


Regulates the activities of the disk drive. 


Disk status 


Lists the status of the last disk operation. It indicates if and when an error occurred 
during this disk access. | 


Disk formats 


The PC market supports several disk formats. PC and XT disk drives use 5-1/4" 

disks that are formatted on one or two sides. Each side contains 40 tracks with 

eight or nine sectors per track (each sector stores 512 bytes). The capacity of these 

disks is between 160K (single-sided) and 360K (double-sided). The AT uses 5-1/4" 

_ disks with two formatted sides, each side containing 80 tracks with 15 sectors per 

track (each sector stores 512 bytes). The total capacity of these disks is 1.2 
megabytes. 


The newest disk formats on the market allow the use of 3-1/2" micro floppy disks. 


Display page 


Also called screen page and video page. Some video cards can control one or more 
display pages. Only one of these pages can be displayed on the screen at one time. 
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DMA 


Abbreviation for Direct Memory Access. Transmits data from the circuit 
chips of a peripheral device directly into memory, without making a detour 
through the CPU. 

DMA controller 


A chip capable of transferring large amounts of data directly into memory without 
passing through the CPU. A good example is the access to a disk drive or hard 
disk drive. 

DOS 
Abbreviation for Disk Operating System. DOS sets up basic file handling 
tasks for communicating between computer and disk drive(s). 

DTA 


Abbreviation for Disk Transfer Area. File and directory accesses use the DTA 
for disk data transmission. Its size depends upon the current operation, where the 
calling program must ensure that enough memory exists to accept the transmitted 
data. After the start of a program, DOS places the beginning of the DTA into 
memory location 128 of the PSP, which makes 128 bytes available. 


ECC 


Abbreviation for Error Correction Code. ECC is used when data is stored on a 
hard disk. Unlike the CRC, the ECC permits the recognition of errors as well as 
their correction within certain parameters. 


EGA 


Abbreviation for Enhanced Graphic Adapter. This is a special, high 
resolution variation on the Color/Graphics Adapter (CGA). 


EMM 
Abbreviation for Expanded Memory Manager. Allows access to EMS memory. 


EMS 


Abbreviation for Expanded Memory System. This section of RAM goes beyond 
the 1 megabyte limit set by PCs and XTs. EMS is only accessible through the 
EMM. 


End character 


Also called return code. The end character is ASCII code 0, which is sometimes 
assigned the name NUL. It usually indicates the last character in a character string. 
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Environment block 


Every program has an assigned environment block whose address is stored in the 
PSP of the current program. The environment block itself consists of a series of 
ASCII strings which contain certain information, such as the search path for files 
(PATH). 

EOI 


Abbreviation for End Of Interrupt. This instruction indicates.the completion of 
a hardware triggered interrupt to the interrupt handler. 


Extended key code 


Keys and key combinations that can be entered with a PC keyboard but have no 
direct relation to the ASCII character set. They are often entered by pressing and 
holding the <Alt> key, then entering a three-digit number on the numeric keypad. 


EXE files 


Executable programs which can be of any length and can store their code, data and 
stack in different memory segments (see also COM files). 


EXEC 


DOS function for loading and executing programs. The command processor also 
uses this function to execute applications programs and batch files. 


FAR instructions 


Machine language instructions that contain an address of a variable or a subroutine 
with a segment address and an offset address. They can address variables or 
subroutines located in another memory segment (farther away than 64K). 


FAT 
Abbreviation for File Allocation Table. This is a table located on every 
external storage medium (disk and hard disk). It informs DOS which areas of a 
storage medium are available, which areas are already occupied with data, and 
which areas are useless because of defects. The FAT also links together the 
different parts of a file. 

FCB 


Abbreviation for File Control Block. DOS controls file access to RAM using 
FCBs. 


Fixed disk 
Another term for hard disk. 
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Filter 


A program that reads characters from the standard input device, manipulates them 
in some desired way, and then displays them on the standard output device. 


Flag register 


A 16-bit register in which several of these bits indicate certain aspects of the 
processor's status. 


Function 
A routine that can be called with a DOS or BIOS interrupt. 


Garbage collection 


A routine that removes variables which are no longer required from the variable 
memory of a BASIC program. Every BASIC interpreter has garbage collection. 


GDT 


Abbreviation for Global Descriptor Table. The GDT describes the individual 
memory segments when the processor is in protected mode. 


General registers 


The processors of the Intel-80xx family have the following general registers: AX, 
BX, CX, DX, DI, SI and BP. They are all 16 bits wide. The AX, BX, CX and DX 
registers can be separated into two 8-bit registers. These two half registers are 
designated as AH, AL, BH, BL, CH, CL, DH and DL. 


Handle 


A numerical value that acts as a key for access to files and devices. It is passed by 
DOS to a program which calls one of the functions for opening or creating a file 
or device. 

Hard disk 


A mass storage unit consisting of several magnetic media stacked on top of one 
another. Unlike disks, hard disks are divided into cylinders and sectors. Each of 
these disks can store data on both their top and bottom sides. 


Hard disk format 


The PC hard disk format consists of 17 sectors per cylinder and 512 bytes per 
sector. The number of disks and the number of cylinders per disk may vary. 


Hardware interrupt 


An interrupt or interrupt request, called by PC hardware, to attract the attention of 
the CPU to a device (e.g., the keyboard). Certain devices only call certain 
interrupts. 
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Hexadecimal system 


A number system distantly related to the binary system. The basic numbering of 
this system goes from 0 to 15, instead of from 0 to 9 (the numbers 10 to 15 are 
represented by the letters A, B, C, D, E and F). The first position of a hexadecimal 
number has the value 1, the second 16, the third 256, the fourth 4,096, etc. 


IN 
Assembly language instruction to read data from a port into the CPU. 


Internal commands 


All commands whose code is stored in the transient portion of the command 
processor, and, therefore, don't have to be loaded from a storage medium (e.g., 
DIR, COPY and VER). 


Interrupt 


An interruption of a program through an interrupt call, the execution of an 
interrupt routine and, finally, the resumption of the interrupted program. The 
processors of the Intel-80xx family can process 256 different interrupts which are 
divided into hardware and software interrupts. 


Interrupt controller 


Monitors the various interrupt requests within the system and decides which 
interrupts to process first. 


Interrupt routine 


The program called during the appearance of an interrupt. Each interrupt has its 
own interrupt routine, whose address is stored in the interrupt vector table. The 
interrupt routine must be terminated with a machine language IRET instruction. 


Interrupt vector table 


A table containing the addresses of the interrupt routines, which are called when a 
particular interrupt appears. Each entry in this table consists of two words. The 
first word contains the offset address and the following word contains the segment 
address of the interrupt routine. The table starts at memory location 0000:0000, 
where the address of the interrupt routine for interrupt 0 is stored. The four 
following memory locations contain the address of the interrupt routine for 
interrupt 1, etc. 


IRET 


The Interrupt RETurn assembly language instruction. IRET terminates the 
execution of an interrupt routine and then continues the execution of the program 
at the location following the interruption of the program. 
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Keyboard status 


Indicates whether the user has pressed the <Shift>, <Ctrl> or <Alt> keys, and 
whether the <Insert>, <CapsLock>, <NumLock> or <ScrollLock> modes are 
active. 


Kilobyte 
Abbreviated as K. Equals 2!” or 1,024 bytes. 


Math coprocessor 


Relieves the CPU of the processing of complicated floating-point mathematical 
formulas. It also accelerates the processing of worksheets within a spreadsheet 


program. 
Megabyte 
Often abbreviated as meg. Equal to 210 kilobytes or 1,048,576 bytes. 


Media descriptor byte 


A byte within the File Allocation Table (FAT), which identifies the mass storage 
device's current format. DOS can manipulate the various formats of the mass 
storage which it supports and also checks the media descriptor byte for the current 
format. 


Memory allocation 


In all PCs the lower 640K is assigned to RAM. The video RAM follows, and then 
the ROM, which extends to the 1 megabyte memory limit. ATs may have up to 
15 megabytes of additional RAM. 


Microprocessor 


The brain of a computer. Its main task is to execute assembly language 
instructions. 


Model identification 


The type of PC used, as coded into address FOOO:FFFE. FCH stands for AT, FEH 
often stands for XT and FFH often stands for PC. 


MS-DOS 


Abbreviation for MicroSoft Disk Operating System. MS-DOS is the 
primary PC operating system. 


Multiprocessing 


The simultaneous execution of several programs (not supported by DOS at the 
time of this writing). 
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NEAR instructions 


Assembly language instructions that contain the offset address of only a variable or 
a subroutine (no segment address). These instructions can address variables or 
subroutines located only within the current 64K memory segment. 


Nibble 


Also spelled nybble. Bytes can be subdivided into two nibbles. The low nibble 
occupies bits 0 to 3 of a byte, while the high nibble occupies bits 4 to 7 of a byte. 


NMI 
Abbreviation for Non-Maskable Interrupt. The NMI remains constantly 
active. It is the only interrupt not affected by the CLI assembly language 
instruction. | 

OUT 
An assembly language instruction which sends data to a port. 

Overlay 
A program loaded into memory allocated for it by another program. The calling — 
program calls certain routines within this overlay as needed. 

Paragraph 


A group of 16 bytes in the 8088 which starts at a memory location divisible by 16 
(e.g., 0, 16, 32, 48, etc.). 
Parent program 


A program that can execute another program (see child program) and continue its 
own processing after the child program's execution. For example, if a FORMAT 
command is called from DOS level, the command processor is the parent program. 


Parity 


A process used to detect errors during serial data transmission. Either even or odd 
parity can be used. 


PC 


Abbreviation for Personal Computer (i.c., all computers equipped with a 8088 
or 8086 processor). 


Peripheral interface 


Connects the CPU to various peripheral devices (e.g., speaker). 
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Ports 


The connections between the CPU and various other circuit chips within the 
system. Each chip has one or more assigned ports, which have a specific address. 
The CPU addresses the individual chips by writing values into the proper port or 
by reading values from the proper port. 

Printer status byte 


Describes the current status of the printer. It can indicate whether the printer is out 
of paper, is switched ONLINE or has not responded (time-out). 


PRN 
The device designation of the printer. 


Program counter 


Also called IP (Instruction Pointer). The program counter and the CS segment 
register combined form the memory address from which the processor will read the 
next command to be executed. 


Protected mode 


Allows multiprocessing, more than 1 megabyte of memory and control over 
virtual memory on computers possessing the 80286 and 80386 processors. 


PSP 


Abbreviation for Program Segment Prefix. The PSP is a 256 byte long data 
structure, which is placed in front of every program to be executed but not stored 
with the file on disk or hard disk. The program itself or program data start after 
this data structure. 


RAM 


Abbreviation for Random Access Memory. This is the memory that the user 
can read from and write to. 


Raw mode 


Character mode that transmits all characters from a device to the calling program 
without any changes (see cooked mode). 


Real mode 


Forces 80286 and 80386 processors to emulate dual high-speed 8088 processors 
incapable of multiprocessing or control of more than 1 megabyte of memory. 


Register 


Memory locations inside the processor that provide faster access than memory 
locations in RAM. 
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Reset 


A resetting and reboot of the system. You can trigger a reset by pressing the 
<Alt><Ctrl><Delete> key combination. 


Resident 


Programs that remain in memory after execution without being overwritten by 
other programs or data. Resident programs can be recalled later. 


ROM 
Abbreviation for Read Only Memory. ROM can only be read, not written. 


ROM BASIC 


A small BASIC interpreter, placed in the ROMs of older PCs starting at address 
F000:6000. ROM BASIC is called by the system when BIOS fails to load the 
operating system. 

RS -232 


An interface that permits the computer to communicate with other devices over 
only one line. The individual data is transmitted serially (i.e., bit by bit). 


RTC 
Abbreviation for RealTime Clock. The battery backed clock on the AT. 


Scan code 


A code passed to the CPU by the keyboard processor when a key is pressed or 
released. It indicates the number assigned to the key within the keyboard. For this 
reason, the scan codes of the various PC keyboards differ from each other. 


Sector 


The smallest data division of a disk or hard disk. A sector contains 512 bytes. 


Segment descriptor 


Describes the location and size of the segment in addition to other information. It 
is used in protected mode on the 80286 and 80386 processors. All segment 
descriptors are gathered in the global descriptor table (GDT). 


Segment register 


The processors of the Intel-80xx family have four 16-bit segments that define the 
beginning of a 64K memory segment. They are named DS, ES, CS and SS. 


Software interrupts 


An interrupt or interrupt request called by a program using the INT instruction. 
Each of the 256 existing interrupts can be called using this instruction. 
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Standard input device 
The keyboard. The standard input can be redirected to another device or a file using 
the < character. 

Standard output device 


The monitor screen. The standard output can be redirected to another device or a file 
using the > character. 


STI 
The STart Interrupts assembly language instruction. This instruction disables 
any previous CLI command and re-enables all inactive interrupts. 
Time-out 
Occurs during communication between the CPU and a device when the CPU sends 
data to the device and, after a certain amount of time, the device offers no response. 
Timer 
Similar to the clock. The timer generates a cyclical signal used to measure time. 
TPA 
Abbreviation for Transient Program Area. This is the part of RAM below the 
1 megabyte limit not occupied by DOS that is used for storing programs and data. 
UART 


Abbreviation for Universal Asynchronous Receiver Transmitter. A chip 
that acts as the controller for the serial interface. 
Video controller 
Displays a picture on the screen by sending the proper signals to the monitor. 
Video RAM 
RAM, which is used for storing characters or graphics for display on the screen, 
made available by a video card. It can be addressed like normal RAM. 
Virtual memory 
Permits program access to memory, which it assumes to be RAM but is actually a 
mass storage device. Virtual memory must first be loaded into RAM for access. 
Volume 


Part of a mass storage device that has files, its own FAT, its own root directory 
and its own subdirectories. Each volume can have its own volume name. While 
disks can store only one volume under DOS, hard disks can be divided into several 
volumes to accommodate several operating systems. 
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Scan Codes 


laee 
(2 


88) 


BS 


RRS 


SRS) 


PCIXT keyboard scan codes 


gene 
vaeae 
Bice. 


HHS 
gea98 


AT keyboard scan codes 


918 


Appendix J 


ASCII Character Set 


qrptrtryeeows MAMA aVHSYS OE°CTMGOM? SHO EOO 


t+ FN §- MMH tH 


ie 


VV I Arwe te ODN HAUPWNHeEFON- 


64 


§ “NK KESCHNDAOWOSZ RPA UHMANHONWPe 


twwem———~ NM MESSE HHA QUOD Se wUrQHoanos 
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Dec. Dec. Dec. Dec. 
Hex Hex Hex Hex 
Chr. | Chr. | Chr. | Chr. 

r r r r 
128 80 ¢ 160 AO a 192 CO + 224 E0 a 
129 81 &@ 161A1i 193c1+ 225 £18 
130 82 € 162 A26 194 C2 7, 226 E27 
131 83 & 163 A3 u 195 C3 | 227 E37 
132 84 A 164 A4 fh 196 C4 — 228 E45 
133 85 € 165 A5 N 19705 + 229 E50 
134 86 A 166 A6 * 198 C6 F 230 E6 pu 
135 87 ¢ 167 A7 2 199 C7 | 231 E7 7T 
136 88 6 168 A8 ¢ 200 c8 £ 232 E8 
137 89 € 169 A9-— 201 C9 F 233 E9 6 
138 8A @ 170 AA- 202 cA# 234 FAN 
139 8B i 171 AB % 203 CB 7; 235 EB 56 
140 8c i 172 AC} 204 CC [F 236 EC 
141 8D i 173 ADj 205 CD= 237 ED @ 
142 8E A 174 AE « 206 CE 238 EE e€ 
143 8F A 175 AF » 207 CF £ 239 EF n 
144 90 EF 176 BO: 208 Do 240 FO = 
145 91 e 177 Bl ® 209 Dl = £241 F1 + 
146 92 £ 178 B2 # 210 D2 7, 242 F2 > 
147 93 6 179 B3 | 211 D3 § 243 F3 < 
148 94 6 180 B4{ 212 D4 & 244 F4 f 
149 95 6 181 B54 213 D5 F 245 F5 J 
150 96 G@ 182 B6 {| 214 D6 g 246 F6 + 
151 97 u 183 B7 ,7 215 D7 + 247 F7 ® 
152 98 y 184 BB 43 216 D8’ + 248 F8 ° 
153 99 6 185 B9 4} 217 p94 249 FO - 
154 9A U 186 BA || 218 DA -- 250 FA - 
155 9B ¢ 187 BBW 219 DBR 251 FB J 
156 9c £ 188 BC+ 220 DC m 252 FC n 
157 9D ¥ 189 BD! 221 ppg 253 FD ? 
158 9E R 190 BE4 222 DE § 254 FE - 

159 OF f 191 BF 7 223 DF @ 255 FF 
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Interrupt 13H, f86-DOS 52 
6845 index register 472 
8042 keyboard processor 712 
8048 keyboard processor 712 
8086 3, 903 
8088 3, 8, 903 
8253 chip 449 
8259 timer chip 671, 712 
80186 3, 903 
80286 3, 903 
80386 3, 903 
Aborting a program 142 
Absolute disk read 844 
Absolute disk write 845 
Activate character set 873 
Activate mouse driver 898 
Adapt to foreign hard disk 743 
Address 8, 903 
Address bus 16, 699, 903 
Address notation 9 
Address operator & 42 
Address register 8 
Address space 8 
AH register 45 
Alarm interrupt 397 
Allocate memory 821 
Allocated expanded memory pages 854 
Allocating memory 121 
Alternate hardcopy 877 
ANSILSYS 55, 148, 156 
Arena header 903 
ASCII 904 
Assembly language 1, 3, 47, 904 
ASSIGN 149 
Asynchronous data transfer 904 


AT 904 
AT hard disk 675 
ATP 330 
Attribute byte 459, 460, 497, 904 
AUTOEXEC.BAT _— 57, 149, 199, 904 
Background color 862 
BACKUP 203 
BASIC 96 
Basic Input Output System (BIOS) 
1, 711, 905 
Batch files 54, 57, 111-112, 904 
Baud 331, 904 
BCD format 396, 566 
Binary coded decimal (BCD) 396, 566, 
00, 904 
Binary system 900, 905 
BIOS 711 
BIOS architecture 220 
BIOS cassette interrupt 714 
BIOS configuration functions 713 
BIOS date functions | 395 
BIOS floppy disk functions 713 
BIOS hard disk functions 714 
BIOS Interrupts: 
Interrupt 1AH, function02H 760 
Interrupt 1AH, functionO3H 761 
Interrupt 1AH, function04H 761 
Interrupt 1AH, functionOSH 762 
Interrupt 1AH, functionO6H 762 
Interrupt 1AH, function 07H 763 
Interrupt 10H, function 13H 726 
Interrupt 13H, function 15H 734 
Interrupt 13H, function 15H 749 
Interrupt 13H, function 16H 734 
Interrupt 13H, function 17H 735 
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Interrupt 15H, function 83H 752 
Interrupt 15H, function 84H 753 
Interrupt 15H, function 85H 754 
Interrupt 15H, function 86H 754 
Interrupt 15H, function 87H 754 
Interrupt 15H, function 88H 755 
Interrupt 15H, function 89H 755 
BIOS Interrupts (XT and AT only): 
Interrupt 13H, functionOOH 736 
Interrupt 13H, functionOAH 744 
Interrupt 13H, functionOBH 745 
Interrupt 13H, functionODH 746 
Interrupt 13H, functionOlH 736 
Interrupt 13H, functionO2H 737 
Interrupt 13H, function03H 738 
Interrupt 13H, function04H 740 
Interrupt 13H, functionOSH 741 
Interrupt 13H, functionO8H 742 
Interrupt 13H, functionO9H 743 
Interrupt 13H, function 10H 747 
Interrupt 13H, functionl11H 748 
Interrupt 13H, function 14H 748 


BIOS keyboard functions 714 
BIOS memory functions 713 
BIOS Parallel printer functions 715 
BIOS Parameter Block (BPB) 157, 160, 
198, 214, 215, 905 
BIOS printer interrupt 385, 715 
BIOS screen output 226 
BIOS serial interface functions 714 
BIOS time functions 395 
BIOS variable memory 398 
BIOS version 223 
Bitfield 887 
Bitmap mode 460, 721 
Bitplanes 521 
Blinking attribute 866 
Block device driver 150, 156, 171, 
194, 816, 905 
Boot sector 59, 185, 197, 905 
Booting 221, 715, 759, 905 
Bootstrap 198, 221 
Border color 862 
BPB—see BIOS Parameter Block 
<Break> key 715, 763 
Breakpoint 668-669, 711 
Buffer 814 
Buffered input | 779 


922 


PC System Programming 


Byte table 840 
C language 104 
CALL 905 
Call ROM BASIC 715, 759 
Calling interrupts 27 
Cancel all files in print queue 848 
Cancel redirection 839 
Carry flag 12, 37, 905 
Cassette interrupt 297, 336 
Cathode ray tube 458 
CD-ROM 193-194 
CGA 254, 463 
Change 121 
Change directory 93 
Change retry count 819 
Character device driver 150, 170, 194, 

815, 906 
Character generator 460, 875 
Character input 766, 774, 777 
Character matrix 469 
Character output 70, 767, 774 
Character set 265, 459, 872 
Character table 715, 765 
Child program 110, 906 
CHKDSK 201 
CLI 23 
Clock 14, 906 
Close file (FCB) 782 
Close file 808 
Clusters 198, 906 
Code segment 10 
Color palette 498, 721, 723 
Color selection register 504, 871 
Color-suppressed mode 498 
Color/Graphics Adapter (CGA) 228, 

254, 497 
COM programs 51, 60, 62, 112, 

825, 906 
COM1 73 
Command processor 53, 56, 111, 907 
COMMAND.COM _ 56, 111,823, 906 
Common registers 6 
Compact disk (CD) 193 
Compatibility 206 
COMSPEC 112 
CONFIG.SYS 59, 85, 149, 156, 

194, 907 


Abacus Index 
Configuration 289 Determine memory size 728, 755 
Configuration register 482 Determine mouse sensitivity 897 
Control codes 233 Determine mouse type 899 
Control record access 835 Determine pointer display page 897, 898 
Control register 471 Determine processor type 653 
Controller diagnostic 748 Determine video card type 880, 881 
Cooked mode 72, 150, 171, 814, 907 Device attribute 77, 814 
Country-specific data 769,770 Device close 166 
CP/M 51-52, 70, 84, 687,907 Device driver 148, 215, 817, 908 
Create file 786, 806, 835 —_ Device driver access 151, 767 
Create new file 835 Device redirection 838 
Create PSP 793 Devices 53 
Create subdirectory 804 Digital Research 52 
Create temporary file 834 DIR command 96 
Critical error handler 57, 142, 800,842 Direct console I/O 776 
Critical error handler address 843 Direct Memory Access (DMA) 13, 325, 
CRT 458, 908 909 
CRT controller (CRTC) 14, 460, Direct video access 457 
462, 857,872 Directory lister programs 96 
<Ctrl> key 359 ~~ Directory search 93 
<Ctrl><Break> 800 Disable lightpen emulation 889, 890 
Cursor definition 232, 716, 856, 857 Disable mouse pointer 883 
Cursor positioning 232, 717,857 Disk access 297, 769 
Cycles 447 Disk change 303, 735 
Cyclic Redundancy Check 324,907 ‘Disk controller 14, 908 
Disk format 735, 742, 908 
DAC color register 867 Disk monitor program 305 
DAC color table 258 Disk operating system 51 
DAC mask register 870 Disk reset | 781 
DAC register group 868 Disk status 730, 908 
DASD 908 Disk transfer area (DTA) 62, 90 
Data bus 16, 699, 908 Disk/hard disk access 769 
Data segment 10 ‘Display attributes 460 
Data structures 196 Display modes 458 
Data transfer protocol 330 Display mouse pointer 882, 883 
Date 54, 395, 715, 759-762, Display page 856-858, 908 
796, 797,829 Division by zero 710 
DEBUG program 172 DMA 13, 325, 909 
Decimal system 900 DOS 4.0 213 
Define cursor type 233,716 DOS 201 
Delete file (FCB) 784 ~+DOS buffer 211 
Delete file 810 DOS flag access 769 
Delete subdirectory 805 DOS functions 96, 206 
Determine configuration 727 DOS Info Block (DIB) 208 
Determine disk format 735 DOS Interrupt 21H, function SCH 835 
Determine drive type 734 DOS kernel 56 
Determine Format of the Hard Disk 742 DOS version number 799 
Determine Hard Disk type 749 DOS-BIOS 56 
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Drive information 789 
Drive Parameter Block (DPB) 209 
Drive table 715, 764 
Driver initialization 148, 156 
DTA 62, 99, 768, 788, 827, 909 
DUMP program 134 
Duplicate handle 820 
EGA 254, 463, 909 
EGA attribute controller 865 
EGA BIOS 254 
EGA character generator 263 
EGA functions 856 
EGA/VGA configuration 856, 877 
EGA/VGA Interrupts: 


Interrupt 10H, function 00H 856 
Interrupt 10H, functionOAH 861 
Interrupt 10H, functionOBH 862 
Interrupt 10H, function OCH 863 
Interrupt 10H, function ODH 863 
Interrupt 10H, function OEH 864 
Interrupt 10H, functionOFH 864 
Interrupt 10H, function 01H 857 
Interrupt 10H, function 02H 857 
Interrupt 10H, function 03H 858 
Interrupt 10H, function OSH 858 
Interrupt 10H, function 06H 859 
Interrupt 10H, function 07H 859 
Interrupt 10H, function 08H 860 
Interrupt 10H, function 09H 861 
Interrupt 10H, function 10H 


865-866 

Interrupt 10H, function 11H 
872-874 

Interrupt 10H, function 11H 
875, 876 

Interrupt 10H, function 12H 
877-878 
Interrupt 10H, function 13H 880 
Electron beam 461 

EMM Interrupts: 

Interrupt 67H, function 0 854 
Interrupt 67H, function 0 854 
Interrupt 67H, function 0 855 
Interrupt 67H, function 1 849 
Interrupt 67H, function 2 849 
Interrupt 67H, function 3 850 
Interrupt 67H, function 4 850 
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Interrupt 67H, function 5 851 
Interrupt 67H, function 6 851 
Interrupt 67H, function 7 852 
Interrupt 67H, function 8 852 
Interrupt 67H, function 9 853 
Enable mouse pointer 882, 883 
End character 909 
End of Interrupt (EOI) 670, 910 
Environment block 112, 208, 823, 910 


Error Correction Code (ECC) 324, 909 
Error display 71 


Exchange mouse event handlers 892 
Exclusion area 621, 890, 891 
EXE programs 51, 60, 66, 112 
825, 910 
EXEC function 
60, 66, 110, 132, 823, 910 
Execute overlay 824 
Execute program 823 
Expanded Memory Manager (EMM) 
849, 852,909 
Expanded Memory Specification (EMS) 
213, 909 
Expanded memory allocation 850 
Expanded memory handles 854 
Expanded memory mapping 851 
Expanded memory segment address 849 
Expanded memory status 849 
Extended FCB 88 
Extended keyboard codes 360, 910 
Extended memory 2Uccation 850 
Extended memory mapping 851 
Extended memory segment address 849 
Extended memory status 849 
Extended MS system page 850 
Extended partitions 688 
Extended read 744 
Extended write 745 
External commands 57 
External hardware interrupt 23 
Extra segment 1] 


FAR instruction 

FAT—see File Allocation Table 
FCB functions 84, 91, 206, 768 
FCB—-see File Control Block 

File access (FCB) 768 
File access (handle) 768 
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File Allocation Table (FAT) 53, 194, 
198, 214, 910 

File Control Block (FCB) 55, 62, 84, 
208 

File date 830 
File handle 55, 70, 85, 768, 820 
File information access 769 
File search using FCB functions 94 


File search using handle functions 95 
File time 830 
Filters 132, 911 
Fixed disk 54, 741, 910 
Flag register 6, 12, 911 
Flush input buffers 162, 164 
Flush output buffers 164 
Force duplicate of handle 820 
Foreign hard disks 743 
FORMAT 202 
Format diskette 733 
Format hard disk 326, 741 
Format hard disk cylinder 741 
Function 911 
Garbage collection 30, 911 
GDT 337,911 
General registers 911 
Get <Ctrl><Break> flag 800 
Get allocation strategy 830 
Get country 802 
Get current directory 93, 821 
Get default drive 788 
Get device information 813 
Get Drive information 789 
Get DTA address 798 
Get extended error information 832 
Get file attributes 811 
Get file date and time 829 
Get free disk space 801 
Get input status 780 
_ Get interim console flag 840 
Get machine name 836 
Get MS-DOS version number 799 
Get pointer position/button status 884 
Get print spool install status 846 
Get printer setup 837 
Get PSP address 839 
Get redirection list entry 837 
Get return code 826 


Index 


Get system date/time 796,797 
Get verify flag 828 
Get video mode 232 
GRAFTABL 234, 721, 764 
Graphic mode 458 
Graphic user interfaces 213 
Gray scales 871, 878, 879 
GW-BASIC 28 
Handle 70, 815, 911 
Handle functions 96 
Hard disk 54, 323 
Hard disk error codes 324 
Hard disk format 911 
Hard disk function calls 325 
Hard disk interrupts 674 
Hard disk partition support 213, 687 
Hardcopy 670, 711 
Hardware interrupt 22, 667, 710, 911 
Hardware (CPU) Interrupts: 
Interrupt OOH 710 
Interrupt 01H 710 
Interrupt 02H 711 
Interrupt 03H 711 
Interrupt 04H 711 
Interrupt OSH 711 
Interrupt 08H 
(8259 interrupt controller) 712 
Interrupt 09H 
(8259 interrupt controller) 712 
Heap 432 
Hercules graphic cards 230, 255, 
463, 482 
Hertz 447 
Hexadecimal system 899, 912 
Hidden files 96 
Hierarchical file system 54 
High density disk drives 303 
High level languages 3, 711, 712 
Hold print jobs for status check 848 
Horizontal synchronization signal 472 
Hotkey 408 
I/O Control Read 160 
1/O Control Write 165 
IBMBIO.COM 59, 202 
IN 464, 699, 912 
Initialize 750 
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Initialize printer 385, 758 Math coprocessor 14, 675, 710 
Input buffer 575 711, 913 
Input status 162, 817 MCB 209 
Installable device drivers 55 MDA 254, 463 
Instruction pointer 10 Media change 734 
INT instruction 27, 47,711, 712 | Mediacheck 158 
int86 function (C) 40-41 Media descriptor 199, 210, 913 
intdos function (C) 41-42 Megabyte 8, 291, 913 
intdosx function (C) 40, 42 Memory 16, 754 
Intel Corporation 3, 712,903 = Memory block allocation 822, 831, 913 
interim console flag (840 Memory Control Block 119, 208, 209 
Interleave factor 210 Memory location 16 
Internal commands 57, 912 Memory release 121, 822 
Internal DOS structure 56 Memory segments 17 
Internal hardware interrupts 23. ~=Microprocessor 3, 8, 575, 913 
Interrupt controller 13, 670, 912 Microsoft Assembler (MASM) 48 
Interrupt requests 13,671 Microsoft C compiler 416 
Interrupt routine 20, 912 Microsoft Corporation 52 
Interrupt vector 801 Microsoft mouse 617 
Interrupt vector table 20, 912 Mode selection register 501, 502 
Interrupts 19 Model identification byte 291, 913 
INTO (INTerrupt on Overflow) Modify allocation (Vers 2 andup) 822 
instruction 711 Monochrome Display Adapter (MDA) 
INTR procedure (Pascal) 36 226, 463, 469, 482, 497 
IO.SYS 59 Mouse button activation counter 
IOCTL 165, 170, 819 884, 885 
IRET (Interrupt RETurn) 19,711 Mouse button release counter 885 
Mouse button status 883, 884 
JOIN 212 Mouse buttons 618 
Joysticks 753 Mouse event handlers 888, 891 
Mouse interface 617 
Keyboard access 72, 358, 712 Mouse interrupts: 
Keyboard controller 576 Interrupt 33H, function OOH 882 
Keyboard output functions 74 Interrupt 33H, functonOAH 887 
Keyboard programming 575 Interrupt 33H, function OBH 888 
Keyboard status 913 Interrupt 33H, functionOCH 888 
Kilobyte 913 Interrupt 33H, funcionODH 889 
Interrupt 33H, function OEH 890 
LASTDRIVE 212 Interrupt 33H, functionOFH 890 
Lightpen 713, 882, 889 Interrupt 33H, function 01H 883 
Logical hard disk 688 Interrupt 33H, functionl1AH 896 
Logical sector 216 Interrupt 33H, function1BH 897 
Low-level formatting 687 Interrupt 33H, function 1CH 897 
Interrupt 33H, function 1DH 897 
Macros 48 Interrupt 33H, function 1IEH 898 
Make directory 93 Interrupt 33H, function 1FH 898 
Maskable interrupts 23 Interrupt 33H, function 02H 883 
Match 826-827 Interrupt 33H, function 03H 884 
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Interrupt 33H, function 04H 
Interrupt 33H, function OSH 
Interrupt 33H, function 06H 
Interrupt 33H, function 07H 
Interrupt 33H, function 08H 
Interrupt 33H, function 09H 
Interrupt 33H, function 10H 
Interrupt 33H, function 13H 
Interrupt 33H, function 14H 
Interrupt 33H, function 15H 
Interrupt 33H, function 16H 
Interrupt 33H, function 17H 
Interrupt 33H, function 18H 
Interrupt 33H, function 19H 
Interrupt 33H, function 20H 
Interrupt 33H, function 21H 
Interrupt 33H, function 24H 
Mouse pointer 618, 622, 882, 
Mouse pointer range of movement 
885, 
Mouse pointer shape 886, 
Mouse programming 
Mouse speed doubling 
Mouse status buffer size 
MOV instruction 
Move file pointer 
Move memory areas 
Move mouse pointer 
MS-DOS 
MSCDEX 
MsDos procedure (Pascal) 
MSDOS.SYS 
MUL instruction 
Multiprocessing 
Multisync monitor 
Multitasking 


4, 835, 


NEAR instruction 
Network 

Nibble 
Non-destructive read 
Non-maskable interrupt (NMI) 23, 
Non-overlapping segments 

Norton Utilities® 208, 


Offset address 
Open 
Open file (FCB) 


8, 42, 


819, 835- 


884 
885 
885 
886 
886 
887 
891 
891 
892 
893 
893 
894 
894 
896 
898 
899 
899 
883 


886 
887 
617 
891 


711 
913 
255 
835 


914 
836 
914 
161 
710 

11 
213 


903 
165 


782. 


Open file 

Operating system area 
OS/2 

Oscillation 

OUT 

Output buffer 

Output character string 
Output status 

Output until busy 
Overlapping segments 
Overlays 

Overscan register 


Palette register 
Paragraph 
Parameter block 
Parent program 
Parity 

Parity bit 

Parse filename to FCB 
Partition code 
Partition sector 
Partitions 

Pascal 

Paterson, Tim 
PATH 

PC 

PC Tools® 
PC-DOS 
Periodic interrupt 
Peripheral interface 
Pipe file 

Pipes 

Pixel 

Pointer position 
Pointer speed 
Ports 

Position cursor 
Predefined handles 
Primary partition 
Print queue 

Print spooler 
print Character 
Printer access 
Printer interrupt 


Printer output functions 


Printer status 
Processor registers 


Index 


807 
119 
687 
447 
464, 699, 914 
575 


865, 877, 878 
914 

111, 823 

110, 840, 914 
332, 914 

331 

795 

689 

688 

323, 687-689 
100 

52 

112-113 

914 

213 

51 

164 
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Processor type 291 
Program calls 110 
Program counter 6, 10 
Program Segment Prefix (PSP) 60, 67 

208, 769, 793, 915 
Program termination 766 
Programmable peripheral interface 13 
Programmable timer 448 
Prompt 57 
Protected mode 337, 915 
<Prt Sc> key 670 
PSP access 769 
PTR data type 155 
RAM 291, 325, 767, 915 
RAM control 767 
RAM determination 291 
Random block read 794 
Random block write 795 
Random read 790 
Random write 791 
Raster 462 
Raster-scan devices 460 
Raw mode 72, 150, 171, 814, 915 
Read 161 
Read character 720, 751, 775, 860 
Read clock count 759 
Read control keys 361 
Read cursor position 232, 718 
Read data from block device 816 
Read data from character device 814 
Read date from realtime clock 761 
Read Disk 730 
Read disk status 299 
Read display mode 726 
Read file 808 
Read hard disk 325, 326, 736,737 
Read hard disk format 328 
Read HI-RAM size 337 
Read input status , 817 
Read Interrupt- Vector 801 
Read joystick 753 
Read Keyboard 361, 756, 757 
Read output status 817 
Read pixel 238, 863 
Read printer status 758 
Read realtime clock 760 
Read status 752 
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Ready 747 
Realtime Clock 336, 395-397, 563, 

674, 761-763 
Realtime clock register 564 
Recalibrate hard disk 329, 748 
Receive character 334 
Receiver shift register 333 
Redirect device 838 
Redirection of interrupts 156 
Refresh rate 461 
Register 6, 35 
Relative addresses 8 
Release extended memory pages 851 
Release memory 822 
Relocation factor 114 
Removable media 167 
Remove directory 93 
Remove file from print queue 847 
Remove mouse pointer 883 
Rename file 787, 828 
Reserved 846 
Reset alarm time 763 
Reset disk 729 
Reset hard disk 736, 737, 746 


Reset input buffer and then input 780 


Reset mouse driver 882, 899 
Resident commands 51 
Resident interrupt driver 373, 391, 675, 

679 
Restore mouse status 893, 894 
ROM BASIC 222, 715, 916 
ROM cartridges 18 
ROM-BIOS 221, 254, 905 
Root directory 202 
RS-232 card 330, 916 
Scan code 360, 575, 916 
Scan lines 877 
Screen border color —865 
Screen controller 14 
Screen refresh 879 
Scrolling 859 
Search directory 768 
Search for match (FCB) 783-784 
Sector 54, 916 
Sector interleaving 326 
Segment address 8, 903 
Segment descriptor 338 


Abacus Index 
Segment register 6, 8, 42,916 Signal controller 460 
Segmented address 8 Single step 667 
Segread 40 Single step interrupt 710 
Select color palette 723 Small registers 7 
Select Current Drive 781 Software interrupt 22,916 
Select current display page 719 SORT 132 
Select drive 781 Sound 447-451 
Select palette 723 Sound demonstration program 451 
Send Character 775 — Special keys 358 
Send character (BIOS printer) 385 Stack segment 11 
Send data to block device 816 Standard input device 917 
Send data to character device 815 Standard output device 917 
Send file to print spooler 847 Status register 503, 564, 575 
Sensegraphic pixel 724 ~=STI 23,917 
Sequential read 785 = Stop bits 331, 332 
Sequential write 786  Subdirectory access 767 
Serial interface 73, 330,751 SUBST 212 
Serial interface functions 73, 76,330 Support chips 13 
Serial port 751 Switch to protected mode 755 
Set <Ctrl><Break> flag 800 System configuration 292 
Set alarm time 762 System Request 754 
Set allocation strategy 831 System request 754 
Set clock count 760 

Set country 804 Teletype output 235 
Set current directory 805 Temporary file 834 
Set date in realtime clock 762 Terminate address 843 
Set disk type 304 Terminate and Stay Resident (TSR) 

Set display page 233 407, 846 
Set DTA address 788 Terminate program 142, 767, 773, 825 
Set file attributes 812 Terminate with return code 825 
Set file date and time 829 Test for changeable block device 818 
Set flag after time interval 752 Test for local or remote drive 818 
Set graphic pixel 237, 724 — Test for local or remote handle 819 
Set mouse display page 622 Text cursor emulation 879 
Set mouse event handler 888 Text mode 458 
Set mouse hardware interruptrate 897 Time 395, 759-763, 768, 797, 829 
Set mouse pointer display page 897 Time and date 767 
Set mouse sensitivity 896 Time measurement 54, 336, 395 
Set pointer shape (text mode) 887  Time-out error 333, 384, 917 
Set printer setup 836 Timekeeping 395 
Set random record number 792 Timer 14, 448, 673, 917 
Set realtime clock 761 TPA—see Transient Program Area 

Set system date 797 Trace mode 668 
Set system time 797 Traditional input/output functions 74 
Set Verify flag 798 Transfer holding register 333 
Setting 333 ‘Transfer shift register 333 
Scan 461 Transient commands 51 
Shell 907 Transient Program Area (TPA) 119, 903 


929 


Index | PC System Programming 


Transmit characters 334 Write character 722, 757, 861, 864 
TRAP bit 710 Write character/attribute 721, 860 
Truncate file 806 Write character/color 861 
TSR 846TSR programs 407 Write to disk 731 
Turbo C Compiler 45,416 Write to file 809 
Turbo Pascal string 38 Write with verify 163 
Typematic 577-579 

XENIX 196, 687 
UART 332 


Undocumented DOS structures 208 
Unfiltered character input without echo 


777 
UNIX 54, 70, 84, 196 
Upwardly compatible 903 
User interface 617 
Verify disk 732 
Verify flag 798, 828 
Verify sector 326, 740 
Vertical synchronization signal 483 
VGA BIOS 254 
VGA character generator 263 


VGA Interrupts: 

Interrupt 10H, function 1AH 881 

Interrupt 10H, function 10H 
866-871 

Interrupt 10H, function 11H 
sub-function 04H 874-876 

Interrupt 10H, function 12H 
sub-function 31H 878-879 


VGA video modes 255 
Video cards 14, 457 
Video controller 458 
Video controller registers 472 
Video functions 713 
Video Graphics Array (VGA) 254, 458 
Video mode 231, 856 
Video page 908 
Video RAM 458, 482, 856 
Video table 764 715 
Virtual memory 4,917 
Volume 917 
Wait 754 
Wildcards 96 
Word 16 
Word length — 331, 332 
Write 163 
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Order Toll Free 1-800-451-4319 


5370 52nd Street SE ¢ Grand Rapids, MI 49512 
Phone: (616) 698-0330 ¢ Fax: (616) 698-0325 


Beginners Books for new PC Users 


Beginners Series books remove the confusing jargon and get you up 
and running quickly with your PC. 


PC and Compatible Computers for Beginners - 
For the absolute newcomer to personal computers. 
Describes the PC and all of its components in a non- 
technical way. Introduces DOS commands. 

ISBN 1-55755-060-3 $18.95 
Canada: 52072 $22.95 


MS-DOS for Beginners - Describes the most 
important DOS commands clearly and 
understandably. Teaches skills required to more 
effectively use your PC. 

ISBN 1-55755-061-1 $18.95 
Canada: 52071 $22.95 


EXCEL for Beginners - Newcomers to this powerful 
spreadsheet and graphics software will learn to master 
Excel's many features in a short while. 

ISBN 1-55755-067-0 $18.95 
Canada: 52067 $22.95 


Microsoft Works for Beginners - A thorough 
introduction to this "all-in-one" software package. 
Loaded with simple, practical examples. 

ISBN 1-55755-063-8 $18.95 
Canada: 52070 $22.95 


Ventura Publisher for Beginners* - Presents the 
basics of the premier desktop publishing package. 
Many examples and illustrations. 

ISBN 1-55755-064-6 $18.95 
Canada: 52074 $22.95 


Companion Disk available for $14.95 each ($19.95 CDN) 


To order direct call Toll Free 1-800-451-4319 
In US and Canada add $4.00 shipping and handling. Foreign orders add ee 00 per item. 
Michigan residents add 4% sales tax. 


Beginners Books for new PC Users 


UNIX for Beginners - Clearly describes this popular 
operating system, Logon procedures, file concepts and 
commands using simple and clear examples. 

ISBN 1-55755-065-4 $18.95 

Canada: 52073 $22.95 


Lotus 1-2-3 for Beginners - Presents the basics with 
examples that are presented clearly and without 
confusing ‘computer jargon’. Includes Release 2.2 
information. 

ISBN 1-55755-066-2 $18.95 
Canada: 52069 $22.95 


GW-BASIC Programming for Beginners* - A simple 
introduction to programming the PC using the BASIC 
language. Learn many of the commands writing sample 
programs and taking chapter quizzes. 

ISBN 1-55755-062-X $18.95 » 
Canada: 52068 $22.95 


Microsoft Word for Beginners - Explains what a 
beginner needs to know to become more productive 
with this powerful word processor. Step-by-step 
examples. 

ISBN 1-55755-068-9 $18.95 
Canada: 52075 $22.95 


COBOL for Beginners* - Teaches this popular 
language using MBP, MicroFocus and Microsoft 
COBOL. Includes quizzes, explanations and 
demonstrations. 

ISBN 1-55755-070-0 $18.95 
Canada: 53904 $22.95 


dBASE IV for Beginners - Simply and easily explains 
the fundamentals of dBASE. Learn to operate this 
package in no time and utilize its powerful commands 
and functions. 

ISBN 1-55755-069-7 $18.95 

Canada: 52066 $22.95 


*Companion Disk available for $14.95 each ($19.95 CDN) 


UNIX. 


| for beginners 


| for beginners 
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To order direct call Toll Free 1-800-451-4319 


In US and Canada add $4.00 shipping and handling. Foreign orders add $12. 00 per item. 
Michigan residents add 4% sales tax. 


_ Beginners Books for new PC Users. 


Beginners Series books remove the confusing jargon and get you up 
and running quickly with your PC. 


PC and Compatible Computers for Beginners - For 
the absolute newcomer to personal computers. 
Describes the PC and all of its components in a non- 
technical way. Introduces DOS commands. 

ISBN 1-55755-060-3 $18.95 
Canada: 52072 $22.95 


MS-DOS for Beginners - Describes the most 
| important DOS commands clearly and understandably. 
ok Teaches skills required to more effectively use your 
PC. 

ISBN 1-55755-061-1 $18.95 

Canada: 52071 $22.95 


EXCEL for Beginners - Newcomers to this powerful 
spreadsheet and graphics software will learn to master : 
Excel's many features in a short while. | forbeginners 
ISBN 1-55755-067-0 $18.95 : 
Canada: 52067 $22.95 


Microsoft Works for Beginners - A thorough 
introduction to this "all-in-one" software package. 
Loaded with simple, practical examples. 

ISBN 1-55755-063-8 $18.95 

Canada: 52070 $22.95 


Ventura Publisher for Beginners* - Presents the 
basics of the premier desktop publishing package. 
Many examples and illustrations. 

ISBN 1-55755-064-6 $18.95 
Canada: 52074 $22.95 


*Companion Disk available for $14.95 each ($19.95 CDN) 
To order direct call Toll Free 1-800-451-4319 


In rosa Canada add $4.00 shipping and handling. Foreign orders add Ste meuiinie _ 
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Beginners Books for new PC Users | 


UNIX for Beginners - Clearly describes this popular , 
operating system, Logon procedures, file concepts and U N ; x 
commands using simple and clear examples. for beginners 
ISBN 1-55755-065-4 $18.95 
Canada: 52073 $22.95 


7 ) Lotus 1-2-3 for Beginners - Presents the basics with 
s 1-2-3 exaipies thal are presented ciearly and without 
for beginners confusing ‘computer jargon’. Includes Release 2.2 
information. 

ISBN 1-55755-066-2 $18.95 

Canada: 52069 $22.95 


Gw.- BASIC Paacmniiniie for Beginners* - A simple 
introduction to programming the PC using the BASIC 
language. Learn many of the commands writing sample 
programs and taking chapter quizzes. 

ISBN 1-55755-062-X $18.95 
Canada: 52068 $22.95 


for beginners 


Microsoft Word for Beginners -** 
Explains what a beginner needs to know to become 
more productive with this powerful word. processor. 
Step-by-step examples. 

ISBN 1-55755-068-9 $18.95 

Canada: 52075 $22.95 


for beginners 


COBOL for Beginners* - Teaches this popular — 
language using MBP, MicroFocus and Microsoft OBOL 
COBOL. Includes quizzes, explanations and fees 
demonstrations. 

ISBN 1-55755-070-0 $18.95 


Canada: 53904 $22.95 


dBASE IV for Beginners - 
Simply andeasily explains the fundamentals of dBASE. 
Learn to operate this package in no time and utilize its 
powerful commands and functions. 

ISBN 1-55755-069-7 $18.95 

Canada: 52066 $22.95 


*Companion Disk available for $14.95 each ($19.95 CDN) 
To order direct call Toll Free 1-800-451-4319 | 


I oncom add $4.00 shipping and handling. Foreign orders add $12 00 pene = 
Michigan residents add 4% sales tax. 


' Developer's Series Books — 


Programming VGA Graphics 

VGA is now the standard display mode 
among the top selling PC software 
packages. If you develop software and 
want to support VGA_ mode, 
Programming VGA Graphics will help 
you write for almost any VGA video card. 
Programming VGA Graphics is a 
collection of language extensions for the 
Turbo Pascal and Turbo BASIC 
programmer. 


Programming VGA Graphics also 
includes real world applications - a game called "The search for alien planet 
Earth" and a multicolor fractal demonstration for video mode 19. 
Beginning programmers and professional developers alike can profit from 
Programming VGA Graphics. What can YOU do with VGA? Find out 
with our Programming VGA Graphics. 670 pages. W/2 companion disks. 
Item # BO99 ISBN 1-55755-099-9. $39.95 

Canada: 57908 $51.95 


QuickBASIC Toolbox 

is forall QuickBASIC programmers who 
want professional results with minimum 
effort. It’s packed with powerful, ready- 
to-use programs and routines you can 
use in your own programs to get 
professional results quickly. 


Some of the topics include: 

e Complete routines for SAA, interfacing 
mouse support, pull-down menus, windows, 
dialog boxes and file requestors 

¢ Descriptions of QuickBASIC routines 

¢ A BASIC Scanner program for printing completed project listings and more 


This book/disk combination will teach you how to write even better 
QuickBASIC. 130 pages. Available March 1991. 


QuickBASIC Toolbox, with companion disk. 
Item # B104 ISBN 1-55755-104-9 $34.95 
Canada: 57911 $45.95 


To order direct call Toll Free 1-800-451-4319. 


In US and Canada add $4.00 shipping and handling. Foreign orders add $12.00 per item. 
Michigan residents add 4% sales tax. 


Productivity Series Books 


PC Assembly Language Step by Step 
For lightning execution speed, no , — 
computer language beats assembly “UAS LY 
language. This book teaches you PC 
assembly and machine language the right 
way - one step at a ime. The companion 
diskette contains a unique simulator 
which shows you how each instruction 
looks as the PC executes it. Includes 
companion diskette containing assembly 
language simulator. 


ISBN 1-55755-096-4. $34.95 
Canada: 53927 $45.95 


Upgrading & Maintaining your PC 
Your PC represents a major investment. 


This book shows you how to turn your 
PC into a high performance computing 
machine. It describes what you'll see 
when you open the "hood" and how all of 
the parts work together. Whether you 
want to add a hard drive, increase your 
memory, upgrade to a higher resolution 
monitor, or turn your XT into a fast AT 
or 386 screamer, you'll see how to do it 
easily and economically, without having 
to be an electronics wizard. 


ISBN 1-55755-092-1. $24.95 
Canada: 53926 $33.95 


To order direct call Toll Free 1-800-451-4319 | 
In US and Canada add $4.00 shipping and handling. Foreign orders add $12.00 per item. 
Michigan residents add 4% sales tax. 
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New BeckerTools 2.0 for Windows: 


Indispensable utilities for every Windows user 


If you’re a Windows user you’ ll appreciate BeckerTools Version 2 
for Windows. BeckerTools will dramatically speed-up your file and 
data management chores and increase your productivity. Where 
Windows’ File Manager functions end, BeckerTools features begin 
by giving you powerful, yet flexible features you need to get the job 
done quickly. BeckerTools has the same consistent user interface 
found in Windows so there’s no need to learn ‘foreign’ commands 
or functions. Manipulating your disks and files are as easy as 
pointing and shooting with the mouse. You’ll breeze through flex- 
ible file and data functions and features that are friendly enough for 
a PC novice yet powerful enough for the advanced user. You won’t 


find yourself “dropping out’ of Windows to perform powerful and essential DOS functions like 
undeleting a file or waiting for a diskette to be formatted. BeckerTools has the enhanced applications 
available with the click of a mouse button. Item #S110 ISBN 1-55755-110-3. With 3 1/2" and 5 1/4" 
diskettes. Suggested retail price $129.95. 


BeckerTools Version 2 is as easy 
as pointing and shooting with the 
mouse. BeckerTools takes ad- 
vantage of Windows’ multitasking 
capabilities and BeckerTools 
keeps you informed ofit’s progress 
as it works. 


~ Becke ools 


File Directory — Backup Disk a Options plications Help 


iles: 0 Dirs: 15 Entries: 15 


Here are some of the things that you can easily do with BeckerTools Version 2: 


e Launch applications - directly from BeckerTools e Edit text - built-in editor with search and replace 


Associate files - logically connects applications 
with their file types 

Backup (pack files) hard disk - saves 50% to 80% 
disk space - with password protection 

User levels - 3 levels for beginning, intermediate 
and advanced users 

Undelete - recover deleted files 

Undelete directories - recover directories in addition 
to individual files 

Delete files - single, groups of files or directories, 
including read-only files 

Duplicate diskettes - read diskette once, make 
multiple copies 


Format diskettes - in any capacity supported by 
your drive and disk type 

Compare diskettes - in single pass 

Wipe diskette - for maximum security 

Screen blanker - prevent CRT “burnout” 

File grouping - perform operations on files as a 
group 

Create a bootable system diskette 

Reliability checking - check for physical errors on 
disk media 

Edit files - new hex editor to edit virtually and type 
of file 

Dozens of other indispensable features 


To order direct call Toll Free 1-800-451-4319 


if US and Canada add $4.00 shipping and handling. Foreign orders add $12.00 per item. 
Michigan residents add 4% sales tax. 


PC System. 
Programming 


An in-depth reference for the DOS programmer 


PC System Programming for Developers is a literal encyclopedia for the DOS programmer. 
Whether you program in assembly language, C, Pascal or BASIC, you'll find dozens of practical, 
parallel working examples in each of these languages. 


PC System Programming for Developers clearly describes the technical aspects of program- 
ming under DOS. More than 900 pages are devoted to making DOS programming easier. 


Some of the topics covered include: 


PC memory organization DOS structures and functions 


Using extended and expanded memory Fundamentals of the BIOS 
Hardware and software interrupts Programming graphics cards 
COM and EXE programs TSR programs and more 


Handling program interrupts in BASIC, Writing device drivers 


Turbo Pascal, C and assembly language 


Look for other books in our Developer's Series. 


Includes two companion disks with over 1 MB of source code. 
__ These disks contain all the source files listed in the book - 


| complete and error-free. Saves you hours of typing in the program file. | 
Abacus |! | | | 
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ISBN 1-55755-036-0 


5370 52nd Street SE « Grand Rapids, MI 49512 $59.95 USA L : 
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